> ## 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.

# Criando categorias

> Crie, edite e exclua categorias para agrupar produtos no catálogo.

# Criando categorias

Categorias ajudam clientes a encontrarem produtos no catálogo. Você pode criar categorias manualmente ou aproveitar as geradas automaticamente na sincronização com fornecedores.

## Pré-requisitos

* Permissão `categories` com ação `create`.
* O módulo **Categorias** habilitado no plano.

## Passo a passo

1. Acesse **Categorias** no menu (`/categorias`) ou **Produtos > Categorias** (`/produtos/categorias`).
2. Clique em **Nova categoria**.
3. Preencha os campos:
   * **Nome** (obrigatório): nome de exibição.
   * **Slug** (obrigatório): identificador usado em URLs (ex.: `canetas-personalizadas`).
   * **Ordem**: número que define a ordem de exibição (padrão `0`).
4. Ative ou desative a categoria com o interruptor **Ativo**.
5. Clique em **Criar categoria**.

## Editar ou excluir uma categoria

1. Na lista de categorias, clique em **Editar** na linha desejada.
2. Altere os campos necessários e clique em **Salvar alterações**.
3. Para excluir, clique em **Excluir** no modal de edição e confirme.

> **Atenção:** Excluir uma categoria não exclui os produtos vinculados. Eles continuarão no catálogo sem categoria associada.

## Opções

* **Ativo**: categoria visível no catálogo.
* **Ordem**: controle de prioridade na exibição (menor número aparece primeiro).
* **Slug**: deve ser único dentro do locatário.

## Erros comuns

* Usar um slug já existente para o locatário.
* Deixar os campos **Nome** ou **Slug** vazios.
* Criar muitas categorias sem ordem definida, dificultando a navegação.

## Solução de problemas

| Problema                      | Causa provável                      | Solução                               |
| ----------------------------- | ----------------------------------- | ------------------------------------- |
| "Dados inválidos"             | Nome ou slug não preenchidos        | Preencha os campos obrigatórios.      |
| "Erro ao criar categoria"     | Slug duplicado ou conflito no banco | Escolha outro slug e tente novamente. |
| Categoria não aparece na loja | Categoria inativa                   | Verifique o campo **Ativo**.          |

## Artigos relacionados

* [Organizando produtos em categorias](./organizing-products)
* [Produtos](../products/index)