> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brindehub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizando produtos em categorias

> Vincule produtos a categorias para facilitar a navegação e os filtros do catálogo.

# Organizando produtos em categorias

Vincular produtos a categorias organiza o catálogo e alimenta o filtro por categoria na listagem de produtos.

## Pré-requisitos

* Permissão `products` com ação `edit`.
* Categorias criadas previamente (veja [Criando categorias](./creating-categories)).

## Passo a passo

1. Acesse **Produtos** (`/produtos`) e clique em **Ver detalhes** no produto.
2. Na seção **Informações gerais**, localize o campo **Categoria**.
3. Selecione a categoria desejada no dropdown.
4. Clique em **Salvar produto**.

> **Dica:** Você pode alterar a categoria a qualquer momento. Produtos sem categoria aparecem como "Sem categoria" nos filtros.

## Passo alternativo durante a criação

Ao criar produtos manuais, a categoria pode ser vinculada posteriormente na tela de detalhes, onde o dropdown é preenchido com todas as categorias do locatário.

> **Importante:** Categorias inativas ainda podem aparecer no painel, mas não serão exibidas na loja. Verifique o status da categoria antes de vinculá-la a produtos ativos.

## Filtro por categoria

A listagem de produtos (`/produtos`) possui um filtro de categoria. Apenas produtos vinculados à categoria selecionada serão exibidos.

## Erros comuns

* Vincular um produto a uma categoria inativa e esperar vê-lo no catálogo.
* Esquecer de salvar após alterar a categoria.
* Criar muitas categorias similares em vez de reaproveitar as existentes.

## Solução de problemas

| Problema                            | Causa provável                  | Solução                                     |
| ----------------------------------- | ------------------------------- | ------------------------------------------- |
| Categoria não aparece no dropdown   | Categoria ainda não criada      | Crie a categoria primeiro em `/categorias`. |
| Filtro por categoria vazio          | Nenhum produto vinculado        | Edite os produtos e selecione a categoria.  |
| Produto aparece em categoria errada | Categoria selecionada incorreta | Reabra o produto e corrija a categoria.     |

## Artigos relacionados

* [Criando categorias](./creating-categories)
* [Editando produtos](../products/editing-products)
* [Busca e ordenação do catálogo](../products/catalog-search-and-sort)
