Todos os artigos
Para além do WooCommerce

Migração de WooCommerce para Medusa.js: Playbook Passo-a-Passo

·6 min de leitura
Antes → depois

O que a migração entrega

WooCommerce hoje
  • Lighthouse (mobile)55
  • TTFB3.5s
  • Alojamento / ano€240
  • Plugin tax / mês€80–€250
Medusa.js + Next.js
  • Lighthouse (mobile)96
  • TTFB0.9s
  • Alojamento / ano€150
  • Plugin tax / mês€0

Se decidiu que a sua loja WooCommerce precisa de mudar — por velocidade, por sanidade dos plugins, por capacidade multi-região — a parte da migração é a que a maioria dos artigos salta. Este é o playbook que sigo em migrações WooCommerce-Medusa. Assume que já leu porque headless ganha em 2026 → e decidiu mudar.

A sequência completa demora 3–6 semanas para uma loja típica abaixo de 500 SKUs. Os riscos a gerir: perda de SEO, integridade dos dados de clientes, continuidade da atribuição de anúncios. Cada um tem um passo dedicado.

O que mantém, o que reconstrói

ElementoCaminho de migração
Catálogo (títulos, descrições, preços, variantes)Importação direta (CSV ou REST API)
Imagens de produtoImportação direta com re-otimização
Categorias e tagsImportação direta
Clientes (email, nome, morada)Importação direta
Histórico de encomendas (read-only)Importação direta
Subscrições ativasRe-implementar em Medusa (sem migração direta)
ReviewsCSV se exportadas do plugin
Aparência do temaReconstruir em Next.js
Plugins personalizadosRe-implementar como módulos Node
Conteúdo (blog, páginas info)Fica em WordPress (sub-domínio) OU migra para Payload CMS
Meta SEO + redirectsMapeamento SEO manual (passo mais crítico)

O que mantém que não esperava

Vantagens que os proprietários descobrem após a migração:

  • Os hábitos da admin WooCommerce transferem-se. A nova admin (Medusa Admin ou Payload CMS) é diferente, mas aprende-se num dia.
  • Deixa de ter medo das atualizações. Sem mais receio do próximo update do WordPress partir três plugins.
  • Editar páginas é instantâneo. Payload CMS publica em menos de um segundo; WordPress eram minutos com plugins de cache.

FAQ

Quanto tempo a loja WooCommerce continua viva durante a migração? A loja antiga corre até ao cutover DNS no fim da semana 6. Não há período de sobreposição em que duas lojas competem — os 301 desde o dia 1 significam que há sempre só um URL ativo.

Os meus URLs de produto mudam? Por defeito, não. A estrutura preserva-se exatamente. Se quiser limpar URLs legacy, é feito explicitamente via mapa 301.

O que acontece às minhas subscrições WooCommerce? Subscrições precisam de re-implementação em Medusa. É o plugin mais difícil de migrar limpo. Conte 2–4 dias adicionais de engenharia e um plano claro de comunicação ao cliente sobre continuidade de billing.

A minha loja Shopify pode ser migrada da mesma forma? Sim, o playbook é praticamente idêntico com especificidades de export diferentes. Porque migrações Shopify são frequentemente mais prioritárias →

Tenho de migrar o blog ao mesmo tempo? Não. O WordPress pode ficar ao lado como sub-caminho (/blog) ou sub-domínio. Proprietários que prefiram o workflow de autoria WordPress podem manter exatamente como está.

Próximos passos

Se chegou até aqui e está a pensar em timing, o próximo passo certo é um orçamento fixo em 24 horas. Envie briefing → — domínio, contagem aproximada de SKUs, principais preocupações — devolvo plano de migração e preço. Builds novos sem migração começam em /services/online-store a partir de €2,000.

Calendário de 6 semanas

Como decorre a migração end-to-end

Cada semana tem um deliverable claro. Mapa SEO primeiro, cutover por último — três riscos (rankings, dados de clientes, atribuição) têm passos de mitigação dedicados.

  1. Semana 1·

    Auditoria + mapa SEO

    • Inventário completo de URLs
    • Mapa de redireccionamentos 301 (antigo → novo)
    • Auditoria de schema + baseline de performance
    • Plugins → funcionalidades nativas
  2. Semana 2·

    Baseline Medusa + importação

    • Regiões, moedas, impostos configurados
    • Pagamentos (Stripe + Multibanco, PayPal)
    • Produtos + clientes + encomendas importados
    • Imagens re-otimizadas → Cloudflare R2
  3. Semana 3–4·

    Storefront Next.js

    • Tema restaurado ou refresh com base em Figma
    • Flows personalizados em React
    • Cart + checkout contra APIs Medusa
    • Pesquisa, filtros, conteúdo em Payload CMS
  4. Semana 4–5·

    Analytics, ads, infra SEO

    • GA4 + Meta Pixel + CAPI (server-side, com deduplicação)
    • Feed GMC com IDs estáveis (sem reset de campanhas)
    • Schema validado no Rich Results Test
    • Sitemap + hreflang + mapa 301
  5. Semana 5–6·

    Cutover + 30 dias de suporte

    • Delta sync final (produtos + encomendas recentes)
    • Troca de DNS (TTL reduzido 48h antes)
    • 301s ativos desde o primeiro minuto
    • Search Console + reconciliação GA4
Preço

Migração — a partir de €1,200

Um único preço-âncora. O orçamento final depende do tamanho do catálogo e da complexidade dos flows a migrar — nunca de tarifas artificiais.

Preço
a partir de €1,200

Orçamento final devolvido em 24 horas após o brief.

O que recebe
  • Mapeamento SEO completo (inventário de URLs + redireccionamentos 301 + schema)
  • Importação de produtos + clientes + encomendas
  • GA4 + Meta CAPI server-side tracking
  • Alojamento em Coolify (primeiro ano)
  • Feed GMC com IDs de produto estáveis
  • 30 dias de suporte pós-lançamento
Controlo de risco

Três riscos, três mitigações

A maioria das migrações falhadas parte nos mesmos três pontos. Cada um tem uma contra-medida dedicada no playbook.

Perda de rankings SEO

Cada URL antigo recebe um destino 301 — sem exceções. Schema reproduzido ou melhorado. A maioria dos clientes recupera rankings em 14 dias; muitos ganham por causa da velocidade.

Corrupção de dados de clientes

Importações dry-run contra staging Medusa. Contagem de clientes, encomendas-amostra e fluxo de reset de password verificados antes do go-live. Email de reset no dia 1 — comunicado antes.

Quebra de atribuição de anúncios

Tracking server-side ativo desde o dia 1 — Pixel e GA4 event IDs continuam durante o cutover. Campanhas com UTM continuam a funcionar porque os landings 301 para as novas páginas.

Tem alguma pergunta?

Fale comigo diretamente

Build específico, preço, timing de migração — tudo o que ficou por responder acima — respondo pessoalmente dentro de um dia útil.

Preencher o brief