# Coleções

As coleções permitem organizar produtos em categorias e subcategorias. No painel de administração, você pode criar, editar e aninhar coleções — cada uma com nome, descrição, imagem e hierarquia próprios. As coleções ativas aparecem na navegação da loja, em uma página de listagem dedicada e nos breadcrumbs dos produtos.

## Navegando pelas suas coleções

Abra **Collections** na barra lateral do painel de administração para ver a lista completa de coleções. A tabela exibe o nome, slug, status, coleção pai, contagem de produtos e data de criação de cada coleção.

![Lista de coleções](/features/collections/collections-list.png)

| Coluna     | Descrição                                                     |
| ---------- | ------------------------------------------------------------- |
| Name       | Nome da coleção com miniatura (clique para editar)            |
| Slug       | Caminho da URL usado na loja (link direto)                    |
| Status     | **Active** (visível para clientes) ou **Inactive**            |
| Parent     | Nome da coleção pai, ou vazio para coleções de nível superior |
| Products   | Número de produtos atribuídos a esta coleção                  |
| Created At | Data de criação da coleção                                    |

Você pode **ordenar** clicando no cabeçalho de qualquer coluna e **pesquisar** digitando na barra de busca. Use o botão **Filter** para filtrar por status ativo ou inativo.

## Ações em massa

Selecione uma ou mais coleções usando as caixas de seleção à esquerda e use a barra de ações em massa que aparece na parte inferior:

- **Activate** — torna as coleções selecionadas visíveis na loja
- **Deactivate** — oculta as coleções selecionadas dos clientes
- **Delete** — remove permanentemente as coleções selecionadas (uma confirmação será exibida)

## Criando uma coleção

Clique em **New Collection** na página de lista de coleções para abrir o formulário de criação.

![Formulário de criação de coleção](/features/collections/create-collection-top.png)

### Detalhes da coleção

| Campo       | Obrigatório | Descrição                                                                                                       |
| ----------- | ----------- | --------------------------------------------------------------------------------------------------------------- |
| Name        | Sim         | O nome da coleção exibido para os clientes. Gera automaticamente um slug de URL.                                |
| Slug        | Sim         | Identificador amigável para URL (minúsculas com hífens). Gerado automaticamente a partir do nome, mas editável. |
| Description | Não         | Texto exibido na página da coleção na loja. Pode ser gerado com IA se habilitado.                               |
| Active      | Não         | Controle de visibilidade na loja. Coleções são inativas por padrão.                                             |

> **Dica:** Se sua loja tem integrações de IA habilitadas, você pode clicar no botão de geração por IA ao lado do campo Description para criar automaticamente uma descrição da coleção a partir do nome.

### Hierarquia

![Criar coleção — hierarquia e imagem](/features/collections/create-collection-bottom.png)

Use o dropdown **Parent Collection** para aninhar esta coleção dentro de uma existente. Selecione **None (top-level)** para mantê-la no nível raiz. As subcoleções aparecem na página da coleção pai na loja e como itens indentados no menu de navegação.

### Imagem

Faça upload de uma imagem para representar a coleção. Esta imagem é exibida na página de listagem de coleções e como banner de destaque na página individual da coleção.

## Editando uma coleção

Clique em qualquer nome de coleção na lista (ou na ação de editar no menu da linha) para abrir o formulário de edição. Ele contém os mesmos campos do formulário de criação, preenchidos com os dados atuais da coleção.

![Editar coleção](/features/collections/edit-collection.png)

Clique em **Save Changes** quando terminar. Você também pode excluir a coleção na página de edição usando a seção de zona de perigo na parte inferior.

## Como as coleções aparecem na loja

Cada coleção ativa é refletida em vários locais da loja visível para os clientes.

### Menu de navegação

O menu de navegação da loja lista todas as coleções ativas. Coleções com subcoleções as exibem como itens indentados quando expandidas.

![Menu de navegação — desktop](/features/collections/storefront-navbar-collections.png)

No mobile, a mesma navegação é acessível pelo ícone do menu hambúrguer. Toque na seta ao lado de **Collections** para expandir a lista.

![Menu de navegação — mobile](/features/collections/storefront-hamburger-collections.png)

### Página de coleções

Ao visitar `/collections` na loja, é exibida uma grade com todas as coleções ativas de nível superior, cada uma mostrando sua imagem, nome e descrição.

![Página de coleções na loja](/features/collections/storefront-collections.png)

### Página individual da coleção

Ao clicar em uma coleção, abre-se sua página dedicada em `/collections/{slug}`. A página inclui:

- Um **banner de destaque** com a imagem da coleção, breadcrumbs, nome e descrição
- Uma **seção de subcoleções** se a coleção tiver filhos
- Uma **grade de produtos** exibindo até 12 produtos por página com paginação
- Uma **mensagem de estado vazio** quando nenhum produto foi atribuído ainda

![Página da coleção na loja](/features/collections/storefront-collection.png)

No mobile, o layout se adapta com uma imagem de destaque em largura total e cards de produtos empilhados.

![Página da coleção na loja — mobile](/features/collections/storefront-collection-mobile.png)

### Breadcrumbs de produtos

Quando um produto pertence a uma coleção, sua página exibe breadcrumbs como **Home > Nome da Coleção > Título do Produto**, ajudando os clientes a navegar de volta à coleção.

### Seções na página inicial

As coleções podem ser destacadas como seções na página inicial usando o construtor de páginas. Você pode escolher entre várias opções de layout (centro, esquerda, direita, largura total) com um botão de chamada para ação personalizável.

## Subcoleções

As coleções suportam uma hierarquia pai-filho. Uma subcoleção:

- Aparece na página da coleção pai na loja como um card clicável
- É exibida como um item indentado abaixo do pai no menu de navegação
- Mostra breadcrumbs completos: **Home > Coleção Pai > Subcoleção > Produto**

Para criar uma subcoleção, defina o campo **Parent Collection** ao criar ou editar uma coleção.

## Páginas legíveis por máquina para LLMs

Cada página de coleção tem uma versão `.md` que retorna markdown puro, projetada para ferramentas de IA e LLMs consumirem facilmente:

- `/collections.md` — lista todas as coleções ativas com links e descrições
- `/collections/{slug}.md` — detalhes completos da coleção incluindo todos os produtos com preços, descrições e links

Esses endpoints retornam conteúdo `text/markdown` e suportam paginação para coleções grandes (ex.: `/collections/summer-sale.md?page=2`).