Pintura a óleo em azul: tech lead de front-end com uma caneca na mão revisa código em dois monitores, à noite
  1. Início
  2. Migrações
  3. Migração VTEX CMS → VTEX IO

Do VTEX CMS legado para o VTEX IO.

Levamos seu storefront do CMS Portal para VTEX IO e FastStore, com catálogo, checkout e operação mantidos na mesma conta e Core Web Vitals no patamar atual.

Muda o storefront, o core da VTEX fica

Catálogo, pedidos, checkout, promoções, pagamento e logística continuam na mesma conta. A migração troca só a camada de experiência.

  • Só o storefront migra: catálogo e checkout ficam como estão.
  • FastStore com SSG e SSR, imagens otimizadas e meta de LCP mobile abaixo de 2,5 s.
  • SEO, slugs e autoridade de domínio preservados.
  • Design system reutilizável em React e TypeScript.
  • Roteiro claro para sair do legado em 3 a 5 meses.

Por que sair do VTEX CMS agora

A própria VTEX direciona a inovação para IO e FastStore. Cada ano no Portal aumenta a distância.

O CMS Portal é legado

Novos projetos e inovação da VTEX vão para IO e FastStore. Ficar no Portal é perder acesso a apps modernos, Intelligent Search, headless e integrações recentes.

Core Web Vitals ruins

Templates do Portal carregam CSS e JS pesados, renderizam no servidor com cache limitado e dificultam métricas verdes no mobile, o que afeta Google Ads, SEO e conversão.

Produtividade baixa

Mudanças simples passam por várias telas, HTML acoplado aos templates e deploy manual. Em IO e FastStore, design system e CI/CD aceleram cada entrega.

SEO técnico limitado

O Portal controla pouco metadados dinâmicos, dados estruturados, sitemap e performance. IO e FastStore entregam SSR, SSG, JSON-LD nativo e controle total do HTML.

Mercado cada vez mais headless

Lojas headless já operam com PWA, personalização e testes A/B nativos. Customizar o legado não fecha essa distância.

Futuro do talento

Profissionais novos preferem React e TypeScript em FastStore a templates antigos do Portal. Migrar amplia o pool de talento e facilita a contratação.

Seis fases, cada uma com gate de decisão

Foco no storefront, preservando o catálogo e o checkout que já rodam na VTEX, com entregáveis objetivos e aprovação conjunta ao fim de cada fase.

  1. 1

    Diagnóstico

    Templates, apps customizados, volume de páginas, performance, SEO e integrações de front, como analytics, personalização e testes A/B. Saída: mapa de escopo e recomendação.

  2. 2

    Planejamento

    Arquitetura FastStore, design system, matriz de páginas, SEO, plano de conteúdo e cronograma. Saída: blueprint aprovado e kick-off.

  3. 3

    Setup

    Projeto FastStore, workspace IO, repositórios, pipelines, acessos e ambientes. Saída: stack pronta para desenvolvimento contínuo.

  4. 4

    Desenvolvimento

    Design system em React e TypeScript, home, PLP, PDP e institucionais, Intelligent Search, ajustes leves de checkout e testes de performance e acessibilidade.

  5. 5

    Cutover

    Workspace master em produção, rota dos domínios trocada para o FastStore, redirects 301 ativos e desligamento gradual do Portal. Downtime efetivo próximo de zero.

  6. 6

    Hypercare

    De 30 a 60 dias de ajuste fino de Core Web Vitals, monitoramento de SEO e conversão, correções pontuais e transferência de conhecimento.

O que você recebe

Do design system ao treinamento, tudo documentado e entregue ao seu time.

Storefront

  • Design system FastStore em React e TypeScript
  • Home, PLP, PDP, institucionais e landing pages em IO
  • Intelligent Search configurado e afinado

SEO e performance

  • Metadados, sitemap e JSON-LD
  • Matriz de redirects 301 do Portal para o FastStore
  • Core Web Vitals verdes como meta, em desktop e mobile

Engenharia

  • Pipeline de CI/CD e workspaces para QA
  • Documentação técnica e guia de manutenção

Time

  • Treinamento de marketing e TI
  • Plano de evolução pós-migração

Riscos típicos e como mitigamos

Cinco riscos de toda migração de storefront, com a resposta definida antes do cutover.

Queda de performance no mobileBudget de performance desde a fase 2, Lighthouse em cada pull request e gates de CI que bloqueiam o deploy se LCP ou CLS piorarem.
Perda de ranking na cauda longaAuditoria de SEO do Portal, matriz 1:1 de redirects, slugs, metadados e sitemap preservados e monitoramento diário no Search Console e no GA4.
Divergência com a identidade visualDesign system revisado com o time de marca antes do desenvolvimento, revisões quinzenais em homologação e aceite formal por tela antes do cutover.
Tags e personalização quebrandoInventário de tags e scripts do Portal, recriação planejada no FastStore via GTM server-side e testes ponta a ponta antes do cutover.
Time sem autonomia depois do go-liveEnablement com treinamentos práticos, documentação viva e sessões hands-on durante o hypercare.

SEO tratado como projeto, do planejamento ao pós go-live

A maior parte das perdas de SEO em migração vem de falta de processo, não de conhecimento. O workstream começa no planejamento e segue intensivo nos primeiros 90 dias depois do go-live.

  • Auditoria do Portal: páginas com mais tráfego orgânico e receita.
  • Matriz 1:1 de redirects 301 para toda URL que mudar.
  • Title, description, JSON-LD de produto, breadcrumb e canonical preservados.
  • Sitemap.xml e robots.txt validados e aceitos no Search Console.
  • Erros 404 monitorados diariamente.
  • Indexação, tráfego orgânico e ranking acompanhados no Search Console e no GA4.

Estimativa de alto nível

Valores e prazos variam com o número de templates, o volume de customizações e a maturidade do design system. A estimativa detalhada sai no fim do diagnóstico.

3 a 6 mesesPrazo típico, do diagnóstico ao go-live
4 a 6 pessoasSquad dedicada
Sob diagnósticoInvestimento definido no fim do diagnóstico

Lojas simples, com poucas páginas e design system definido, podem ficar entre 2 e 3 meses. Marketplaces multiloja e multi-idioma podem chegar a 7 ou 8 meses.

Migração VTEX CMS para VTEX IO: análise

Por que o VTEX CMS virou um problema

O VTEX CMS Portal foi a base de dezenas de milhares de lojas VTEX por mais de uma década, mas o modelo de templates no portal e apps legados envelheceu. Core Web Vitals entraram no ranking do Google, Intelligent Search e headless viraram a base da inovação da VTEX e os times querem trabalhar com React, TypeScript, CI/CD e design system.

Não é uma questão de migrar ou não, e sim de quando. Quanto mais cedo a loja sai do legado, menor o custo técnico acumulado e mais rápido o retorno em conversão, SEO e produtividade.

FastStore, a ponte natural para o headless

FastStore é o framework open source mantido pela VTEX para storefronts headless. Baseado em Next.js, entrega SSG e SSR, imagens otimizadas por padrão, JSON-LD pronto e integração direta com as APIs da VTEX.

Para quem vem do Portal, a curva é controlada: a CCX tem starter interno, design system base, biblioteca de componentes e templates de página que aceleram o projeto em semanas. O resultado é um storefront próprio, com as mesmas ferramentas que os grandes nativos digitais usam.

SEO na migração: processo antes e depois do go-live

Muitas migrações perdem SEO por falta de disciplina, não de conhecimento. Antes do go-live, mapeamos as URLs antigas com tráfego orgânico relevante, classificamos por receita e montamos a matriz 1:1 de redirects 301. Title, description, JSON-LD de produto, breadcrumb e canonical são preservados em cada página migrada.

Depois que o novo site sobe, os primeiros 90 dias são de monitoramento intensivo no Search Console e no Google Analytics, com auditorias externas, erros 404 acompanhados diariamente e sitemap.xml e robots.txt conferidos. Se algum padrão de URL entra em queda, há plano de reação rápida.

O que acontece com o checkout e as integrações

O core da VTEX não muda. Catálogo, pedidos, checkout, promoções, pagamento e logística seguem na mesma conta, com os mesmos apps e integrações. A migração atua no storefront, nas camadas visuais e de experiência.

Isso reduz o risco operacional: não há risco de perder pedidos no cutover, as integrações com SAP, ERP e OMS continuam intactas e WMS e TMS não são tocados.

Time, governança e continuidade

Para o time interno, a migração é uma atualização de stack. Marketing configura campanhas numa interface mais moderna, TI trabalha com React, TypeScript e CI/CD e o time de performance ganha visibilidade sobre Core Web Vitals por ambiente.

A CCX entrega a base, os treinamentos, os playbooks e um hypercare com o time interno operando junto. Seis meses depois do go-live, a maioria dos clientes evolui o storefront com a CCX em squad sob demanda ou advisory, não mais em projeto fechado.

Perguntas frequentes

Preciso migrar catálogo ou checkout também?

Não. A migração do VTEX CMS para IO e FastStore é focada no storefront. Catálogo, checkout, pagamentos, promoções e integrações continuam na mesma conta VTEX, sem alterações.

Quanto tempo leva a migração?

Projetos típicos levam de 3 a 6 meses. Lojas simples, com poucas páginas e design system razoavelmente definido, podem ficar entre 2 e 3 meses. Marketplaces multiloja e multi-idioma podem chegar a 7 ou 8 meses.

Vou perder SEO ao migrar?

Com disciplina de processo, não. Um workstream dedicado de SEO acompanha toda a migração, com matriz de redirects 301, slugs e metadados preservados e monitoramento depois do go-live.

Haverá downtime no cutover?

O downtime efetivo é próximo de zero. A troca de rota do domínio para o workspace FastStore leva minutos, em janela de baixo tráfego.

Posso manter meus apps VTEX atuais?

A maior parte continua funcionando, porque o core da plataforma não muda. Revisamos app a app no diagnóstico para identificar os legados que precisam ser substituídos.

E as integrações com ERP, OMS e WMS?

Não são tocadas. Elas conversam com o core da VTEX, não com o storefront. Por isso o risco operacional desta migração é muito menor que o de uma troca de plataforma.

Qual a faixa de investimento?

Depende do número de páginas, da complexidade do design system e do volume de customizações atuais. A estimativa detalhada sai no fim do diagnóstico.

Como fica a manutenção depois do go-live?

Há três modelos: squad dedicada sob demanda, advisory mensal ou projetos fechados de evolução. A maioria dos clientes começa com uma squad reduzida nos primeiros seis meses e depois passa para advisory.

Pronto para sair do VTEX CMS legado?

Trinta minutos com um engenheiro da CCX, sem custo, para avaliar seu Portal atual e o caminho até o FastStore.