Home / Blog

Guia de Upgrade para Umbraco 17: O Que Muda e Como Planejar

Carlos Casalicchio · Nov 2026 ·8 min de leitura

O Umbraco 17 é a versão atual de suporte estendido (LTS) do Umbraco e roda em .NET 10. Se o seu site ainda está no Umbraco 13, 10 ou anterior, o upgrade vai chegar, planejado ou não. Este guia mostra o que mudou, como escolher entre upgrade direto e migração e como proteger o posicionamento no Google durante a mudança.

O que mudou entre o Umbraco 13 e o Umbraco 17

A maior mudança veio no Umbraco 14: o back office foi reconstruído do zero com web components. O antigo back office em AngularJS deixou de existir. Para os editores os conceitos continuam os mesmos, mas para os desenvolvedores todo dashboard, editor de propriedade e extensão do back office precisa ser reconstruído.

Upgrade direto ou migração?

A partir do Umbraco 13, o upgrade direto costuma ser possível: atualize os pacotes, rode as migrações do banco e reconstrua as extensões do back office. A partir do Umbraco 8 ou anterior, o modelo de dados e as APIs estão tão distantes que construir um novo site em Umbraco 17 e migrar o conteúdo costuma sair mais limpo e mais barato. Ferramentas da comunidade como o uSync Migrations ajudam a mover conteúdo entre versões.

Um plano prático de upgrade

  1. Auditoria: liste a versão, todos os pacotes, código personalizado, integrações e tarefas agendadas.

  2. Decida pacote a pacote: atualizar, substituir ou reconstruir. Isso define a maior parte do esforço.

  3. Ensaie em uma cópia: rode o upgrade ou a migração completa em uma cópia de homologação com dados de produção, nunca direto em produção.

  4. Reconstrua as extensões do back office para o novo back office.

  5. Teste com os editores: deixe que publiquem conteúdo real na homologação antes do lançamento.

  6. Faça a virada: congele o conteúdo por pouco tempo, sincronize o conteúdo final, troque o tráfego e monitore.

Proteja o seu SEO na mudança

A maior parte do tráfego perdido em mudanças de CMS vem de URLs que mudam sem redirecionamento. Antes do lançamento, exporte todas as URLs publicadas do sitemap e do analytics, compare com o novo site e crie um redirecionamento 301 para cada URL que mudar. Verifique títulos, meta descrições, canonical, hreflang e sitemap na homologação e rode um rastreamento completo logo após o lançamento.

Aprendemos isso no nosso próprio site: quando reconstruímos o splatdev.com em Umbraco 17, os rastreamentos depois do lançamento encontraram problemas que uma verificação manual não pegaria. Veja os detalhes no nosso estudo de caso.

Quanto tempo leva?

Depende da quantidade de tipos de documento, templates, pacotes e integrações. Um site institucional pequeno pode migrar em poucas semanas. Sites multilíngues grandes com ferramentas próprias no back office levam mais tempo, e a maior parte desse tempo vai para pacotes e extensões, não para o conteúdo.

Precisa de ajuda?

Planejamos e executamos upgrades e migrações para Umbraco 17 e desenvolvemos plugins Umbraco para Umbraco 13 e 17. Fale conosco para uma avaliação de upgrade.

Want more articles like this?

Subscribe for updates on .NET, Umbraco, nopCommerce, and software engineering.

Get in touch →