← Todos os guias Shopify Horizon

Guia de migração para o Shopify Horizon: Diferenças arquiteturais, mapeamento de layout e continuidade da navegação

Roteiro técnico completo para migrar do Dawn para o Shopify Horizon. Como esquemas de blocos aninhados e navegação desacoplada protegem sua loja.

A transição entre gerações de temas no Shopify é uma das operações técnicas mais sensíveis para uma operação de e-commerce. Com a chegada do Horizon, lojas operando no Dawn encaram uma decisão decisiva: Como migrar sem danificar a arquitetura de categorias, os layouts de produtos e os fluxos de conversão?

Embora o Horizon traga avanços em blocos aninhados e Web Components, a atualização não ocorre em um clique. As configurações visuais estão presas a arquivos JSON exclusivos de cada tema.

Examinamos neste guia técnico as divergências arquiteturais, o mapeamento de esquemas e o papel da navegação desacoplada na continuidade do negócio.

Principais conclusões sobre migração e arquitetura
  • Incompatibilidade de esquema : O Horizon substitui seções planas por blocos aninhados. Como o settings_data.json não é compatível, cabeçalhos customizados voltam ao padrão.
  • Navegação desacoplada vs monolítica : Menus fundidos ao Liquid exigem reconstrução manual a cada troca de tema. Desacoplar a navegação blinda a taxonomia.
  • Protocolo de homologação : Migrações robustas demandam ambientes de teste paralelos, mapeamento de tokens e auditorias Lighthouse antes da publicação.
  • Vantagem do Navi+ : Ao servir menus por uma camada independente no cliente, abas móveis e mega menus continuam ativos sem retrabalho no Horizon.

Guia de migração para o Shopify Horizon: Diferenças arquiteturais, mapeamento de layout e continuidade da navegação Ilustração conceitual: Caminho de migração das seções tradicionais do Dawn para os blocos modulares do Horizon.


1. Divergências arquiteturais: Dawn vs Horizon nos bastidores

Três diferenças estruturais devem orientar seu planejamento técnico:

1. Seções planas vs blocos aninhados

  • Dawn : Estrutura rígida de seções que exigia alterações manuais no Liquid para menus avançados.
  • Horizon : Blocos aninhados (blocks: [{ type: 'column', blocks: [...] }]), conferindo enorme flexibilidade visual mas reformulando os arquivos JSON.

2. Camada JavaScript

  • Dawn : Elementos customizados distribuídos com risco de listeners concorrentes.
  • Horizon : Web Components modulares e padronizados para hidratação previsível.

3. Tokens de design

  • Dawn : Mistura de CSS estático e variáveis Liquid inline.
  • Horizon : Variáveis CSS customizadas e tokens universais.

Guia de migração para o Shopify Horizon: Diferenças arquiteturais, mapeamento de layout e continuidade da navegação Ilustração técnica de referência: Transição estrutural para Web Components no Horizon.


2. O dilema da navegação: Por que trocar de tema desconfigura os menus

O Shopify preserva links no banco de dados (link_lists), mas elementos ricos (imagens, badges, colunas) residem no settings_data.json do Dawn. O Horizon não interpreta esses identificadores e reinicia o menu em texto simples.

[Shopify Database (link_lists)] ──> Contains only: Title + URL
                                          │
    ┌─────────────────────────────────────┴─────────────────────────────────────┐
    ▼                                                                           ▼
[Dawn settings_data.json]                                           [Horizon settings_data.json]
- Block IDs: "header-1", "mega-menu-a"                             - Incompatible block schema
- Visual attributes: Images, Badges                                - CANNOT READ DAWN METADATA
- Result: Custom styling destroyed upon theme swap                 - Result: Resets to raw default text

3. Casos práticos: Como grandes marcas operam grandes atualizações

Caso 1: Gymshark (Ambientes isolados e serviços externos)

  • Isola busca, checkout e moedas do tema gráfico para prevenir quebras.
  • Novos temas são homologados em ambiente privado antes do lançamento.

Caso 2: Allbirds (Padronização de design tokens)

  • Alinhamento prévio de paletas e fontes para evitar regressões nas páginas.

Guia de migração para o Shopify Horizon: Diferenças arquiteturais, mapeamento de layout e continuidade da navegação Observação no mundo real: Elementos visuais sofisticados em menus sujeitos a apagamento na troca de tema.


4. Compensações técnicas: Reconstrução nativa vs Navegação desacoplada

Critério Reconstrução nativa no Horizon Navegação desacoplada (Navi+)
Esforço de configuração Alto (Reconfiguração manual de bloco em bloco) Mínimo (Ativação via App Embed; paridade imediata)
Dependência de código 100% amarrado ao Liquid do Horizon 0% dependência; distribuído via Edge CDN
Mobilidade futura Exigirá nova reconstrução em trocas futuras Permanece ativo em qualquer tema ou arquitetura headless
UX mobile Gaveta comum no topo esquerdo Bottom Tab Bar persistente ao alcance do polegar
Manutenção Edições manuais em cada branch de tema Painel único com sincronização automática

5. Roteiro passo a passo para migrar ao Horizon

Adote as 5 etapas estruturadas para realizar a migração com total segurança:

[Phase 1: Audit & Discovery]
  ├─ Audit active Dawn extensions and third-party app scripts
  ├─ Document custom Liquid modifications
  └─ Extract design tokens (colors, font families, spacing scales)

[Phase 2: Staging Theme Preparation]
  ├─ Install clean Horizon theme in Staging (do NOT publish to live)
  ├─ Configure Horizon global settings using mapped design tokens
  └─ Build core page templates (PDP, Collection, Cart)

[Phase 3: Navigation & Interaction Layering]
  ├─ Decision Point: Rebuild native menus OR activate decoupled navigation
  ├─ If Decoupled (Navi+): Enable App Embed on Staging Horizon
  └─ If Native: Manually configure Horizon nested navigation blocks

[Phase 4: Multi-Device Testing & Benchmarking]
  ├─ Run Core Web Vitals audit (LCP, CLS, INP) across mobile and desktop
  ├─ Test mobile drawer and bottom tab bar on physical devices
  └─ Verify checkout routing and multi-market localization

[Phase 5: Production Cutover & Monitoring]
  ├─ Publish Horizon during lowest traffic window
  ├─ Monitor real-time analytics on primary navigation funnels
  └─ Retain Dawn as a rollback backup for 14 days

6. Cenários de borda e pontos de atenção técnica

Atente-se aos novos pontos de injeção de scripts no Horizon, cheque prefixos de idiomas do Shopify Markets e fixe alturas no cabeçalho contra CLS.


7. O papel do Navi+: Continuidade com navegação desacoplada

O Navi+ hospeda seus menus no Cloudflare R2. Ao testar o Horizon em staging, basta habilitar o App Embed para que mega menus e barras móveis funcionem de imediato.


8. Lista de verificação antes do lançamento

  • Testes concluídos em tema de rascunho não publicado?
  • Trechos customizados de Liquid no Dawn mapeados?
  • Paridade de todos os links de cabeçalho confirmada?
  • Métricas Core Web Vitals plenamente validadas?
  • Tema Dawn preservado para reversão emergencial?

Fontes e documentação técnica

  1. Shopify Developer Documentation, Themes Architecture: Migrating to Blocks and Web Components (Shopify Editions 2025/2026).
  2. Shopify Theme CLI Reference, Working with Section and Template JSON Schemas.
  3. W3C Web Components Specifications, Custom Elements and Shadow DOM Standards.
  4. Google Chrome Developers, Optimizing Core Web Vitals during Major Theme and Framework Migrations.
  5. Nielsen Norman Group (NN/g), Site Navigation Redesign: Managing User Disruption and Continuity.
Compartilhar Facebook X LinkedIn

Crie uma navegação que seus clientes vão adorar

O Navi+ ajuda você a criar menus de alta conversão para Shopify e qualquer site — sem código.

Experimente o Navi+ grátis See Live Demo →
Explore menus: Bottom Tab Bar • Desktop Mega Menu • Hamburger Menu • Floating Button • Plans & Pricing

Comece com Navi+

Escolha sua plataforma — gratuito para instalar, ao vivo em minutos.