Etiquetas (Labels)

Etiquetas são tags de texto com cor que podem ser aplicadas a issues para categorizar, agrupar e filtrar. Diferente do status (que define onde a issue está no workflow) e da prioridade (que define urgência), etiquetas são livres e servem para classificação cruzada.

Criando etiquetas

Etiquetas são criadas no nível do workspace e ficam disponíveis para todos os projetos dentro daquele workspace.

Para criar:

1. Acesse Workspace → Configurações → Etiquetas
2. Clique em Nova etiqueta
3. Preencha:
   • Nome: texto da etiqueta (ex: frontend, performance, v2.1)
   • Cor: cor de fundo do badge (use cores que contrastem bem com texto branco ou preto)
4. Clique em Salvar

Também é possível criar etiquetas inline ao editar uma issue: no campo de etiquetas, digite o nome da nova etiqueta e clique em Criar "{nome}".

Aplicando etiquetas a issues

No formulário de criação ou na edição da issue:

1. Clique no campo Etiquetas
2. Pesquise pelo nome ou scroll pela lista
3. Clique para adicionar (uma issue pode ter múltiplas etiquetas)
4. Clique novamente para remover

Casos de uso comuns

• Por camada técnica: frontend, backend, banco-de-dados, infra
• Por produto/feature: auth, dashboard, notificacoes, pagamentos
• Por versão: v1.0, v2.0-beta, next
• Por tipo de trabalho: refactoring, testes, documentacao, seguranca
• Por origem: cliente-acme, feedback-usuario, bug-report
• Por estado: precisa-de-design, aguardando-aprovacao, blocked

Filtrando por etiqueta

Na barra de filtros do projeto: Filtros → Etiqueta → selecione uma ou mais.

Múltiplas etiquetas no filtro usam operador OR: mostra issues que têm qualquer uma das etiquetas selecionadas.

Gerenciando etiquetas

Em Workspace → Configurações → Etiquetas:

• Editar: mude o nome ou a cor de uma etiqueta existente. A mudança reflete automaticamente em todas as issues que usam a etiqueta
• Deletar: remove a etiqueta e a desassocia de todas as issues. A operação não pode ser desfeita

Boas práticas

• Use nomes em minúsculas com hífens para consistência (code-review, não Code Review)
• Evite criar muitas etiquetas similares — prefira consolidar
• Etiquetas de versão como v2.0 são úteis para planejar releases
• Combine com filtros para criar "views" rápidas de trabalho (ex: todas as issues backend + Em progresso)