Nova Collections API do Shopify: Subcoleções, Variantes e o Modelo Multi-Source

O Shopify reformulou por completo a maneira como coleções funcionam. A versão 2026-07 da GraphQL Admin API traz um modelo baseado em fontes (sources) que elimina a separação rígida entre coleções manuais e inteligentes. Na prática, uma coleção agora pode combinar regras automáticas, seleções manuais, exclusões e até outras coleções como ingredientes de um mesmo agrupamento.

O que muda com o modelo multi-source

Até a versão anterior, existiam dois tipos de coleção: manual (você escolhe produto por produto) e inteligente (automatizada por regras). Escolhia um, vivia com as limitações do outro. A nova API acabou com essa dicotomia.

Agora cada coleção possui um array de fontes. Cada fonte contribui com membros: produtos ou variantes. O Shopify une todas as fontes, subtrai o que estiver marcado como exclusão e reavalia o conjunto automaticamente quando produtos e variantes mudam. Isso abre possibilidades que antes exigiam gambiarras com apps de terceiros.

Subcoleções nativas

Uma das mudanças mais pedidas pela comunidade. Antes, simular subcoleções exigia tags, menus aninhados e muita paciência. Com a API 2026-07, uma coleção pode referenciar outra coleção como fonte. Isso cria uma estrutura pai-filho nativa.

Um exemplo concreto: a coleção \"Vestuário Feminino\" pode ter como fontes as subcoleções \"Vestidos\", \"Blusas\" e \"Calças\". Se um produto entra em \"Vestidos\", entra automaticamente em \"Vestuário Feminino\". Sem duplicação, sem manutenção manual.

Coleções em nível de variante

Outra limitação histórica cai por terra. Antes, coleções trabalhavam apenas com produtos inteiros. A partir de agora, é possível incluir variantes específicas, como uma cor ou um tamanho, sem arrastar o produto todo para a coleção.

A aplicação imediata: promoções cirúrgicas. Quer dar 20% de desconto apenas nos tamanhos de viagem de uma linha de cosméticos? Crie uma coleção com essas variantes. Descontos e impostos respeitam a coleção, então a promoção funciona sem mexer nas demais variantes do mesmo produto.

Fontes compartilháveis por apps

Apps podem criar fontes reutilizáveis que qualquer coleção da loja pode consumir. Um app de recomendação, por exemplo, pode manter uma fonte dinâmica de \"produtos em alta\" que o lojista insere em múltiplas coleções sem configurar nada manualmente.

O que fazer agora

Se você é lojista, a boa notícia: coleções existentes continuam funcionando. A migração é incremental. Porém, lojas que querem aproveitar subcoleções e variantes precisam de apps atualizados para a versão 2026-07 da API. Apps que não atualizaram simplesmente não enxergam os novos recursos.

Para agências e desenvolvedores, o recado é claro: atualizar apps e integrações para a versão 2026-07. Quem atualizar primeiro entrega mais valor. Quem demorar vai ouvir reclamações de lojistas perguntando por que as subcoleções não aparecem no app deles.

Perguntas frequentes

Preciso migrar minhas coleções existentes para o novo modelo?

Não imediatamente. Coleções manuais e inteligentes existentes seguem funcionando e são atualizadas automaticamente no admin. A migração para o modelo multi-source é opcional e incremental.

Subcoleções funcionam com o tema padrão da loja?

As subcoleções são gerenciadas pela API e pelo admin. A renderização no tema depende de como o tema trata navegação e menus. Temas atualizados devem suportar a estrutura pai-filho nativamente.

Posso usar coleções por variante em promoções e descontos?

Sim. Coleções em nível de variante funcionam com descontos e impostos do Shopify. Uma promoção vinculada a uma coleção de variantes se aplica apenas àquelas variantes específicas.

Na prática, o que a Shakers recomenda

O modelo multi-source resolve problemas reais que a Shakers enfrenta em projetos de catálogo complexo. Lojas com centenas de SKUs e variantes de cor, tamanho e material ganham organização sem depender de workarounds. Se sua operação Shopify sofre com categorização engessada, vale testar a nova API em ambiente de desenvolvimento antes de aplicar em produção. A Shakers pode ajudar na estratégia de migração e na definição da arquitetura de coleções ideal para o seu catálogo.