> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags

> Use Tags para categorizar e encontrar rapidamente Documentos relacionados em seus Espaços.

Pense nas Tags como rótulos rápidos, inline, que você adiciona enquanto escreve para tornar tudo encontrável depois. Elas fazem parte do seu texto, um distintivo leve, não um banco de dados separado que você precisa manter.

* **Pastas** são onde as coisas vivem.
* **Tags** são como você encontra e conecta coisas entre Pastas.

Use Pastas para armazenamento e estrutura de longo prazo; use Tags para cortar temas (ideias, projetos, pessoas, estágios) sem reorganizar seu espaço de trabalho.

<iframe src="https://www.youtube-nocookie.com/embed/eEYGEX2xlDU" title="Tags in Craft overview" className="w-full aspect-video rounded-xl" allowFullScreen />

## Primeiros passos

Ative as Tags nas Configurações do Espaço e comece a criá-las inline enquanto escreve.

<Steps>
  <Step>
    Vá para **Configurações do Espaço** e selecione **Tags**.
  </Step>

  <Step>
    Ative o recurso Tags para o seu Espaço.
  </Step>
</Steps>

<img src="https://mintcdn.com/craft-support/i6CE6W2a4t-4UUEp/images/organize-and-find/tags/en/content/enable-tags.png?fit=max&auto=format&n=i6CE6W2a4t-4UUEp&q=85&s=8f83dee3e3e0a0a6fe1d8f1240bcb16b" alt="Ative as Tags nas Configurações do Espaço" width="1228" height="912" data-path="images/organize-and-find/tags/en/content/enable-tags.png" />

### Criando Tags

Digite `#` seguido do nome da Tag. Pressione Enter para criar uma nova Tag, ou selecione uma existente nas sugestões. O texto vira um pequeno distintivo inline no corpo do seu texto.

<img src="https://mintcdn.com/craft-support/i6CE6W2a4t-4UUEp/images/organize-and-find/tags/en/content/create-tag.png?s=bf667c55976631567899129e2f88f501" alt="Criando uma tag com o símbolo #" width="800" height="701" data-path="images/organize-and-find/tags/en/content/create-tag.png" />

Enquanto você digita após `#`, Craft sugere Tags existentes. Escolha uma para manter os nomes consistentes. Se nada combinar, pressione Enter para criar uma nova Tag.

<Info title="Editar Tags">
  Clique (ou pressione e segure) uma Tag para editá-la no lugar ou removê-la. Para renomear ou excluir todas as ocorrências de uma Tag de uma vez, clique com o botão direito na Tag na visualização de Tags.
</Info>

## Onde as Tags funcionam

As Tags podem ser adicionadas em vários contextos no Craft:

* **Documentos & Blocos**: As Tags são inline e podem ser adicionadas em qualquer lugar onde você escreva - parágrafos, cabeçalhos, itens de lista, etc.
* **Coleções**: Tags digitadas em campos de texto aparecem como texto comum (não como um chip colorido), mas funcionam como Tags para busca e filtragem. Se você quiser ênfase visual maior ou opções mais rígidas, considere campos de seleção única ou múltipla.
* **Tarefas & Calendário**: As Tags também aparecem como texto simples aqui, mas continuam funcionando por trás das cenas quando essas tarefas ficam dentro de Documentos.

<Warning title="Limitação do Inbox">
  O Inbox é um local temporário. Se você marcar uma tarefa no Inbox, ela não vai aparecer na visualização de Tags até você mover a tarefa para um Documento.
</Warning>

## Navegar pela visualização de Tags

A visualização de Tags permite ver todas as ocorrências de uma tag pelos seus Documentos.

* **Abra**: Clique em uma Tag no seu texto e escolha **Ir para a tag**, ou clique em uma Tag fixada no sidebar.
* **O que você verá**: Uma lista de lugares onde essa Tag aparece; ao passar o mouse a linha exata é destacada no contexto.
* **Refinar com filtros**: Adicione mais Tags para restringir os resultados e descobrir conexões entre tópicos.
* **Tags fixadas**: Fixe suas Tags mais importantes no sidebar para acesso com um clique a uma visualização pré-filtrada, por exemplo tags de "projeto ativo", "ideias" ou "diário".
* **Renomear ou excluir**: Clique com o botão direito em uma Tag para renomeá-la ou excluí-la. A alteração vale para todas as ocorrências da Tag em seus Documentos.

<Frame>
  <video autoPlay muted loop playsInline>
    <source src="https://mintcdn.com/craft-support/SMbMCgoSFIFQYydW/images/organize-and-find/tags/en/content/rename-tags.mp4?fit=max&auto=format&n=SMbMCgoSFIFQYydW&q=85&s=cc29371a6877e83242a2d41ec36cfd16" type="video/mp4" data-path="images/organize-and-find/tags/en/content/rename-tags.mp4" />
  </video>
</Frame>

## Tags filhas

Às vezes você quer um pouco de estrutura sem criar dezenas de Tags separadas. Adicione uma barra (`/`) dentro de uma Tag para criar uma hierarquia leve de Tags relacionadas sob um tema comum.

### Como funciona

Crie Tags filhas adicionando uma barra entre a Tag pai e a filha:

```
#project/design
#project/development
#project/marketing
```

Quando você clica em `#project` na visualização de Tags, você verá todos os Documentos marcados com qualquer Tag relacionada ao projeto. Clique em `#project/design` para restringir para apenas os Documentos relacionados ao design.

<img src="https://mintcdn.com/craft-support/i6CE6W2a4t-4UUEp/images/organize-and-find/tags/en/content/child-tags.png?s=41dd608bf9700025e761566f31204919" alt="Tags filhas com notação de barra" width="800" height="444" data-path="images/organize-and-find/tags/en/content/child-tags.png" />

### Exemplos práticos

<Tabs>
  <Tab title="Gestão de projetos">
    Organize o trabalho por fase do projeto ou disciplina:

    * `#clientA/research` – Pesquisa e descoberta de usuário para o Cliente A
    * `#clientA/design` – Trabalho de design e mockups
    * `#clientA/development` – Tarefas de implementação
    * `#clientA/review` – Feedback e revisões
  </Tab>

  <Tab title="Organização de conteúdo">
    Agrupe notas por tópico e subtópico:

    * `#learning/javascript` – Tutoriais e notas de JavaScript
    * `#learning/design` – Princípios de design e inspiração
    * `#learning/productivity` – Dicas de produtividade e fluxos de trabalho
  </Tab>

  <Tab title="Vida pessoal">
    Categorize projetos pessoais e interesses:

    * `#home/renovation` – Ideias e planos de reforma da casa
    * `#home/maintenance` – Tarefas de manutenção regulares e cronogramas
    * `#travel/europe` – Planejamento e memórias de viagens pela Europa
    * `#travel/asia` – Planejamento e memórias de viagens pela Ásia
  </Tab>

  <Tab title="Leitura e pesquisa">
    Acompanhe fontes e tópicos:

    * `#book/fiction` – Notas de livros de ficção
    * `#book/nonfiction` – Notas de livros de não ficção
    * `#article/tech` – Artigos sobre tecnologia
    * `#article/business` – Artigos sobre negócios e estratégia
  </Tab>
</Tabs>

### Benefícios das Tags filhas

* **Flexibilidade** - Adicione novas Tags filhas sem reestruturar todo o seu sistema de Tags
* **Facilidade de descoberta** - Encontre todo o conteúdo relacionado clicando na Tag pai, ou restrinja com uma Tag filha
* **Simplicidade** - Não há necessidade de criar hierarquias formais de Pastas ou estruturas complexas de banco de dados
* **Pessoal** - Cada membro da equipe pode organizar sua própria hierarquia de Tags em Espaços compartilhados

### Dicas para usar Tags filhas

<Info title="Mantenha raso">
  A hierarquia tem **um nível** de profundidade (`parent/child`). Apenas a primeira barra divide a Tag; em `#project/design/ui`, a Tag filha é uma única Tag chamada `design/ui`. Nomes de filhas longos são difíceis de lembrar, então mantenha-os curtos. Se você precisar de mais estrutura, considere usar Pastas em vez disso.
</Info>

**Comece amplo e depois especialize**: Comece com alguns pais. À medida que sua coleção crescer, adicione Tags filhas quando notar subtópicos claros surgindo.

**Misture abordagens**: Nem toda Tag precisa ter filhas. É normal ter tanto `#project/design` (com hierarquia) quanto `#urgent` (autônoma) no mesmo Espaço.

**Fixe pais no sidebar**: Fixe a Tag pai (`#project`) no sidebar para acesso rápido. As Tags filhas aparecem quando você clica para a visualização de Tags.

## Configurações e controle

Personalize como as Tags funcionam no seu Espaço:

* **Ativar/desativar por Espaço**: Em **Configurações do Espaço → Tags**, você pode ativar ou desativar as Tags nesse Espaço. Em Espaços compartilhados, as Tags ficam desativadas por padrão para membros; cada pessoa pode ativá-las individualmente.
* **Lista de ignorados**: Evite que padrões indesejados se tornem Tags (por exemplo, números, códigos hexadecimais ou palavras específicas). Use as regras predefinidas ou adicione as suas personalizadas.
* **Observações visuais**: Nos Documentos, as Tags aparecem como distintivos inline; em Coleções, Tarefas e Calendário elas aparecem como texto comum, mas continuam funcionando como Tags.

<img src="https://mintcdn.com/craft-support/3VhrdGkG_6rMuxcc/images/organize-and-find/tags/en/content/tag-settings.png?s=7091bb69b1cf43aeff61aa2c0ead83a5" alt="Configurações de Tag e lista de ignorados" width="800" height="476" data-path="images/organize-and-find/tags/en/content/tag-settings.png" />

## Observações e limitações

* **Espaços compartilhados**: Outros membros podem ver as Tags usadas no Espaço. Tags fixadas são pessoais; personalize seu sidebar como preferir.
* **Organização do sidebar**: Você pode mostrar/ocultar Tags ou Pastas, reordená-las e usar a seção Favoritos (expansível, com o "+") para itens favoritos. Consulte [Personalizando o Sidebar](/pt-BR/introduction/navigation) para ver o passo a passo completo.