# Tags

# Como gerenciar as Tags

As tags são etiquetas personalizadas que você pode criar e aplicar a diferentes registros do sistema, como contatos, imóveis, negócios, contratos, eventos, vistorias, financeiro e seguros. Com elas, você organiza e identifica rapidamente informações relevantes dentro de cada módulo.

No dia a dia, as tags ajudam sua equipe a categorizar registros de forma visual e padronizada. Por exemplo, você pode criar uma tag "Cliente Inadimplente" para contatos, outra "Temporada" para contratos ou "Excelente vista" para imóveis, facilitando buscas e identificação rápida em listas.

As tags são configuradas neste módulo de cadastro e ficam disponíveis para uso em outros módulos do sistema conforme o tipo selecionado. Para criar ou excluir tags, seu perfil precisa ter as permissões "Tags: Cadastrar" e "Tags: Deletar" ativas.

**Rotina:**<span style="white-space: pre-wrap;"> Configurações &gt; Cadastros &gt; Tags</span>

#### **1. Navegação no módulo**

![Navegação até o módulo de Tags](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/ijI00-gif-navegacao.gif)Este GIF mostra o caminho de acesso até a listagem de tags no sistema.

#### **2. Como funciona**

A tela inicial exibe todas as tags cadastradas no sistema em formato de lista. Para cada tag, você visualiza o tipo ao qual ela pertence, o nome da tag, a cor associada, o identificador automático (slug) e a data da última alteração. A lista exibe até 50 registros por vez, e você pode navegar entre as páginas ou ajustar a quantidade exibida.

No topo da tela estão os filtros de busca: campo de busca inteligente por texto, filtro por tipo de tag, filtro por intervalo de data de atualização e filtro por situação (ativo ou inativo). Use os filtros para localizar rapidamente uma tag específica entre os registros cadastrados.

<p class="callout info">O sistema exibe o identificador automático de cada tag entre parênteses na coluna "Tag". Esse identificador é gerado a partir do nome e é usado internamente para distinguir tags com nomes semelhantes.</p>

#### **3. Cadastrando uma nova tag**

<span style="white-space: pre-wrap;">Clique em </span>**Cadastrar**<span style="white-space: pre-wrap;"> para abrir o formulário de criação. Preencha os campos conforme a necessidade e salve para que a tag fique disponível nos módulos correspondentes.</span>

<table id="bkmrk-campo-descri%C3%A7%C3%A3o-obri" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 160px;"></col><col></col><col style="width: 110px;"></col></colgroup><tbody><tr><th style="width: 160px; white-space: nowrap;">Campo

</th><th>Descrição

</th><th class="align-center" style="width: 110px; white-space: nowrap; text-align: center;">Obrigatório

</th></tr><tr><td>Tipo de Tag

</td><td>Define em qual módulo a tag poderá ser utilizada. Os tipos disponíveis incluem Contato, Imóvel, Negócio, Contrato, Evento, Vistoria, Financeiro e Seguro. A tag só aparecerá para seleção dentro do módulo correspondente ao tipo escolhido.

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>Cor da Tag

</td><td>Cor visual exibida junto à tag nas listagens e registros. Facilita a identificação rápida por cores. Selecione na paleta disponível.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Descrição da Tag

</td><td>Nome da tag como ela aparecerá para os usuários no sistema. Use nomes claros e padronizados, por exemplo: "Cliente Inadimplente", "Temporada" ou "Excelente vista".

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>Slug

</td><td>Identificador único da tag gerado automaticamente a partir do nome preenchido, caso você deixe este campo em branco. Você pode preencher manualmente se preferir um identificador diferente. Uma vez gerado, serve para distinguir tags com nomes semelhantes.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Ícone da Tag

</td><td>Ícone visual que pode ser associado à tag para facilitar a identificação. Selecione na lista de ícones disponíveis.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Ativo

</td><td>Controla se a tag está disponível para uso nos módulos. Quando desativada, a tag deixa de aparecer para seleção em novos registros, mas permanece cadastrada no sistema.

</td><td class="align-center" style="text-align: center;">Não

</td></tr></tbody></table>

<p class="callout warning">O slug é gerado automaticamente se você deixar o campo vazio. Após salvo, o slug identifica a tag de forma única. Evite duplicar nomes iguais em tipos diferentes sem personalizar o slug, pois isso pode gerar identificadores com sufixos automáticos, como "em\_juridico-1".</p>

#### **4. Visualizando os detalhes do formulário**

Ao rolar o formulário, você visualiza os campos de ícone e a chave de ativação da tag. Certifique-se de deixar a chave "Ativo" ligada para que a tag fique imediatamente disponível para uso após salvar.

<p class="callout success">Mantenha um padrão de nomenclatura para as tags da sua equipe. Nomes claros e consistentes facilitam a busca e evitam duplicações desnecessárias na lista.</p>

#### **5. Resultado após o cadastro**

<span style="white-space: pre-wrap;">Após salvar, a nova tag aparece imediatamente na listagem com todas as informações preenchidas: tipo, nome, cor, slug e data de alteração. Você pode clicar em qualquer tag da lista para editar suas informações ou usar o botão </span>**Remover**<span style="white-space: pre-wrap;"> para excluir as tags selecionadas.</span>

<p class="callout danger">A exclusão de uma tag é permanente. Antes de remover, verifique se a tag não está em uso em contratos, contatos ou outros registros ativos no sistema.</p>

#### **6. Perguntas frequentes**

**Posso usar a mesma tag em mais de um módulo, por exemplo em Contato e em Negócio ao mesmo tempo?**  
Não diretamente. Cada tag pertence a um tipo específico. Se precisar de uma tag com o mesmo nome em dois módulos diferentes, cadastre-a duas vezes, uma para cada tipo. O slug gerado automaticamente receberá um sufixo para diferenciá-las.

**O que acontece com os registros que já usam uma tag se eu desativá-la?**  
Desativar uma tag impede que ela seja selecionada em novos registros, mas não remove a tag dos registros que já a utilizam. Os vínculos existentes permanecem intactos.

**Posso editar o nome de uma tag já em uso?**  
Sim. Clique na tag na listagem para abrir o formulário de edição e altere o nome. O slug não é atualizado automaticamente ao editar o nome, portanto, se necessário, atualize o slug manualmente também.

**Por que algumas tags aparecem com sufixo numérico no slug, como "-1"?**  
Isso ocorre quando duas tags têm nomes que geram o mesmo slug automático. O sistema adiciona um sufixo para garantir que cada tag tenha um identificador único. Para evitar isso, preencha o campo "Slug" manualmente com um valor diferente ao cadastrar.

**Preciso de alguma permissão especial para criar ou excluir tags?**  
Sim. Seu perfil de acesso precisa ter as permissões "Tags: Cadastrar" para criar e editar, e "Tags: Deletar" para remover tags. Caso esses botões não apareçam na tela, entre em contato com o administrador do sistema para verificar suas permissões.