# Tags

> Etiquetas livres nos perfis para organizar e filtrar membros, com nome e cor. Como pôr, renomear, fundir e excluir, os limites, a tag automática de palestrante e a diferença entre tag e grupo.

**Tags** são etiquetas que você põe nos perfis dos membros: *Turma 2026*, *Mentor*, *Cliente VIP*, *São Paulo*, *Indicado pela Ana*. Servem para **encontrar e filtrar** pessoas na lista de membros.

## Para que serve

| Comunidade | Tags úteis |
|---|---|
| Escola online | *Turma março*, *Turma abril*, *Concluiu o curso*, *Bolsista* |
| Coworking | *Residente*, *Flex*, *Andar 2*, *Evento interno* |
| Comunidade de clientes | *Cliente VIP*, *Plano anual*, *Beta tester* |
| Associação | *Diretoria*, *Voluntário*, *Associado desde 2020* |

## Tag ou grupo?

| | **Tag** | **Grupo** |
|---|---|---|
| Para quê | Organizar e filtrar | Dividir a comunidade **e** liberar acesso |
| Libera espaços? | Não | Sim, na lista **Quem tem acesso** |
| Tem líder e hierarquia? | Não | Sim, e pode ficar dentro de outro grupo |
| Aparece no organograma? | Não | Sim |
| Exemplo | *Cliente VIP* | *Turma de março*, que abre a sala da turma |

Regra prática: se a etiqueta precisa **abrir uma porta**, é um grupo. Se só ajuda a achar gente, é uma tag. Ver [Grupos e organograma](/membros/grupos-e-organograma).

## Como funciona

### Limites

- Cada tag tem de **1 a 40 caracteres**: *"Cada tag precisa ser um texto de 1 a 40 caracteres."*
- Cada perfil pode ter **até 20 tags**.
- Não há limite de tags na comunidade.

### Tags de sistema

Algumas tags são postas pela plataforma, e ninguém as edita. Hoje há uma: **Palestrante** (*"Submeteu proposta a uma chamada de trabalhos"*), em quem submeteu proposta a uma [chamada de trabalhos](/espacos/chamada-de-trabalhos). Serve para chamar de novo os palestrantes na próxima edição.

### Quem pode

Pôr, tirar, renomear, colorir e excluir tags: **proprietário**, **administrador** e **moderador**.

## Passo a passo

### Pôr tags num membro

*Papel: proprietário, administrador ou moderador.*

1. **Administração › Membros**, na coluna **Tags** da pessoa (ou na edição dela), clique em **Adicionar tag**.
2. Na janela **Tags do membro**, busque uma tag existente ou digite uma nova e escolha **Criar "…"**.
3. Salve: *"As mudanças valem ao salvar."*

### A aba Tags

**Administração › Membros › Tags** lista as tags em uso, com quantas pessoas carregam cada uma (*"3 pessoas"*). Por ali:

- **Renomear**: muda a tag em todo mundo que a carrega (*"A tag 'Mentor' será reescrita em 12 perfis."*). Renomear para o nome de uma tag que **já existe** funde as duas: *"'Mentores' já existe, com 4 pessoas. As duas viram uma só, e isso não se desfaz."* (**Fundir as duas**).
- **Cor**: muda a cor com que a tag aparece.
- **Excluir**: a tag sai de todos os perfis; os perfis continuam (*"A tag 'Beta' sai de 8 perfis."*, **Excluir de todos**).

### Filtrar por tag

Na lista de **Membros**, use o filtro **Tags**.

## Exemplos

**Separar turmas para os avisos.** Ponha *Turma março* em 30 alunos e *Turma abril* em 25. Na hora de mandar um recado, filtre pela tag e copie os e-mails.

**Juntar duas tags parecidas.** Metade da equipe usou *Mentor*, a outra metade *Mentores*. Em **Tags**, renomeie *Mentor* para *Mentores* e confirme **Fundir as duas**.

**Encontrar palestrantes antigos.** Filtre pela tag **Palestrante** antes de abrir a próxima chamada de trabalhos.

## Erros comuns e como resolver

| Mensagem | O que fazer |
|---|---|
| *Cada tag precisa ser um texto de 1 a 40 caracteres.* | Encurte a tag |
| *Um perfil pode ter no máximo 20 tags.* | Tire tags que não servem mais |
| *Tag não encontrada nesta comunidade* | Ela foi excluída ou renomeada; recarregue |
| *Não foi possível renomear a tag.* | Tente de novo; se persistir, recarregue a página |

## Perguntas frequentes

**O membro vê as próprias tags?**
As tags são uma ferramenta da equipe, na tela de Membros.

**Posso liberar um espaço por tag?**
Não. Para liberar acesso, use um grupo.

**A tag Palestrante pode ser tirada?**
Não: é uma tag de sistema, derivada de ter submetido proposta.

## Na API

`PUT /api/profiles/{id}/tags` (substitui a lista), `GET /api/profiles/tags`, `PUT /api/profiles/tags/{tag}` (renomear), `PUT /api/profiles/tags/{tag}/color` e `DELETE /api/profiles/tags/{tag}`. Ver [Profiles](/api/referencia/profiles).

## Relacionados

- [Grupos e organograma](/membros/grupos-e-organograma)
- [Gerenciar membros](/membros/gerenciar-membros)