# Campos customizados e templates

Adapte o KrakenDock ao jeito do seu time. Os campos customizados acrescentam informações próprias aos cards, como cliente, severidade ou trimestre. Os templates de card preenchem cards repetitivos, como um relato de bug, com descrição, labels e subtarefas prontas. Os templates de projeto criam projetos novos já com boards, colunas, labels, campos e templates de card.

Este guia é para quem administra projetos e organizações e para quem cria cards no dia a dia.

> Versão em Markdown puro deste guia: [https://app.krakendock.com/docs/fields-templates.md?lang=pt-BR](https://app.krakendock.com/docs/fields-templates.md?lang=pt-BR). Use-a para colar num assistente de IA ou na documentação interna do seu time.

## Visão geral

| Recurso              | O que faz                                       | Onde se configura                                                         |
| -------------------- | ----------------------------------------------- | ------------------------------------------------------------------------- |
| Campos customizados  | campos extras que todo card do projeto pode ter | Configurações do projeto → **Campos**                                     |
| Templates de card    | modelos que preenchem um card novo              | Configurações do projeto → **Templates**                                  |
| Templates de projeto | a estrutura inicial de um projeto novo          | **Configurações** → **Templates de projeto** (sua conta ou a organização) |

Os detalhes estão em [Campos customizados](#campos-customizados), [Templates de card](#templates-de-card) e [Templates de projeto](#templates-de-projeto).

### Template de card ou template de projeto?

- O template de card vive dentro de um projeto. Você o escolhe ao criar um card, e ele preenche aquele card (e cria as subtarefas dele).
- O template de projeto vive na sua conta ou na organização. Você o escolhe ao criar um projeto, e ele monta a estrutura: boards e colunas, labels, campos customizados, templates de card e a sprint inicial.
- Um template de projeto pode carregar templates de card. Um template de card nunca cria projetos.
- Nenhum dos dois copia cards, páginas da wiki, membros ou anexos.

## Campos customizados

Cada projeto define os próprios campos. Os campos valem para todos os cards do projeto, em qualquer board.

### Criar um campo

Você precisa da permissão **Gerenciar projeto**.

1. Abra o projeto e vá em **Configurações → Campos**. A opção fica no grupo **Trabalho**.
2. Clique em **Novo campo**.
3. Preencha o **Nome** (até 60 caracteres, único no projeto, sem diferenciar maiúsculas) e escolha o **Tipo**.
4. Nos tipos de seleção, cadastre as **Opções**, cada uma com nome e cor.
5. Se quiser, ligue **Obrigatório** e **Mostrar no card**. Salve.

O tipo não muda depois de criado. Para trocar o tipo, crie outro campo.

### Tipos de campo

| Tipo                 | Valor no card                                             |
| -------------------- | --------------------------------------------------------- |
| **Texto**            | até 5.000 caracteres                                      |
| **Número**           | entre -10¹⁵ e 10¹⁵, com decimais                          |
| **Data**             | um dia, sem hora                                          |
| **Seleção única**    | uma das opções                                            |
| **Seleção múltipla** | várias opções                                             |
| **Caixa de seleção** | marcada ou desmarcada                                     |
| **Link**             | um endereço `http://` ou `https://`, até 2.048 caracteres |
| **Pessoa**           | um membro do projeto                                      |

### Opções, obrigatoriedade e exibição

- **Opções**: só nos tipos **Seleção única** e **Seleção múltipla**. São de 1 a 50 opções, com nome de até 60 caracteres (sem repetir) e cor `#RRGGBB`. Use **Adicionar opção** e as setas para ordenar. Renomear uma opção mantém os cards que a usam.
- **Obrigatório**: o card mostra o campo com `*` e destaca o valor vazio. O card pode ser criado sem o valor, mas, depois de preenchido, o valor não pode ser apagado, só trocado. A caixa de seleção é exceção: desmarcar sempre é permitido.
- **Mostrar no card**: exibe o valor como etiqueta nos cards da board e nas linhas da lista. A lista de campos marca esses campos com **No card**.

### Preencher no card

Abra o card. A seção **Campos** mostra todos os campos do projeto, na ordem definida nas configurações. Cada valor é salvo assim que você o altera. Para limpar um valor, apague o texto ou escolha a opção vazia.

- Quem tem a permissão **Editar cards** preenche os valores. Os outros só leem.
- O histórico do card registra cada mudança de valor.
- Na board, os valores aparecem se o campo tiver **Mostrar no card** ligado. Para escondê-los só para você, abra **Exibição** na board e desligue **Campos** em **Propriedades no card**. Na densidade **Compacta**, os valores não aparecem.

### Filtrar a lista por campo

Na página **Cards** do projeto, o botão **Campos** abre um filtro para cada campo:

| Tipo do campo                            | Filtro                                                       |
| ---------------------------------------- | ------------------------------------------------------------ |
| Seleção única, seleção múltipla e pessoa | marque uma ou mais opções (ou **Eu**, em pessoa) e **Vazio** |
| Caixa de seleção                         | **Qualquer**, **Marcado** ou **Desmarcado**                  |
| Número                                   | **Mín.** e **Máx.**                                          |
| Data                                     | **De** e **Até**                                             |
| Texto e link                             | **Contém…** (sem diferenciar maiúsculas)                     |

- As opções marcadas no mesmo campo somam resultados (uma ou outra). Filtros de campos diferentes se combinam (um e outro).
- Você combina até 20 filtros de campo, junto com os outros filtros da lista.
- Os filtros ficam na URL (`cf=<id do campo>:<operador>:<valor>`), então dá para mandar o link ou guardar num filtro salvo.
- **Limpar filtros de campos** remove só os filtros de campo.

A board não tem filtro por campo. Use a lista.

### Editar, reordenar e excluir

- As setas da lista de campos mudam a ordem em que eles aparecem no card.
- Ao editar, você muda nome, opções, **Obrigatório** e **Mostrar no card**.
- Remover uma opção apaga esse valor de todos os cards que a usam. O KrakenDock pede confirmação em **Remover e salvar**.
- Excluir um campo apaga os valores dele em todos os cards. Não dá para desfazer.

## Templates de card

Um template de card guarda um card pronto de um tipo (tarefa, bug ou história). Ele fica no projeto e não muda os cards já criados com ele.

### Criar um template de card

Você precisa da permissão **Gerenciar projeto**.

1. Vá em **Configurações → Templates** do projeto e clique em **Novo template**.
2. Preencha **Nome** (até 60 caracteres, único no projeto) e **Tipo**.
3. Preencha o que o template deve trazer:
   - **Prefixo do título**: até 60 caracteres, por exemplo `[Bug] `. Inclua o espaço no fim, se quiser um.
   - **Descrição**: até 20.000 caracteres, em Markdown. Bom lugar para um roteiro ("Passos para reproduzir", "Resultado esperado").
   - **Labels**, **Prioridade** e **Estimativa** (número inteiro, zero ou mais).
   - **Subtarefas**: até 20, cada uma com título (até 255 caracteres) e tipo. Use **Adicionar subtarefa**.
4. Ligue **Padrão para este tipo** se o template deve vir escolhido sempre que alguém criar um card desse tipo. Cada tipo tem no máximo um padrão, marcado com **Padrão** na lista.
5. Salve.

### O que o template preenche

Ao criar um card com o template:

- o título ganha o prefixo, a não ser que já comece com ele. O título completo tem até 255 caracteres;
- a descrição do template entra quando a descrição do card fica vazia;
- prioridade, estimativa e labels vêm do template. Labels que foram excluídas do projeto são ignoradas;
- as subtarefas são criadas como filhas do card, na mesma board, coluna e sprint.

O que você preenche no card vale mais do que o template.

### Usar ao criar um card

1. Abra o diálogo de card novo: menu **Criar** → **Novo card**, o botão `+` no topo de uma coluna da board ou o botão flutuante no celular.
2. Escolha o **Tipo**. O campo **Template** lista só os templates desse tipo e já vem com o padrão, se houver.
3. O diálogo mostra o prefixo ao lado do título e um resumo com labels, prioridade, estimativa e subtarefas.
4. Escreva o título e clique em **Criar card**.

Escolha **Nenhum** em **Template** para criar o card em branco. A criação rápida no rodapé da coluna (**Adicionar card**, atalho `c`) não usa templates.

## Templates de projeto

### Criar um projeto a partir de um template

1. Clique em **Criar** → **Novo projeto** e escolha o dono do projeto.
2. No campo **Template**, escolha um dos cartões. Cada um resume as colunas, as labels, os campos, os templates de card e a sprint. **Ver detalhes** mostra tudo o que o projeto vai ter.
3. Com **Em branco**, você escolhe a **Metodologia da primeira board** (Scrum ou Kanban), e o projeto nasce com uma board de três colunas. Com qualquer outro template, a metodologia vem do template.
4. Clique em **Criar projeto**.

A lista mostra os templates prontos e os templates salvos pelo dono escolhido: os seus (selo **Salvo**) num projeto pessoal, ou os da organização (selo **Da organização**). Para abrir a página já com um template escolhido, use o parâmetro `template`, por exemplo [/new?template=scrum](https://app.krakendock.com/new?template=scrum).

### Templates prontos

| Template       | Board e colunas                                                             | Também traz                                                |
| -------------- | --------------------------------------------------------------------------- | ---------------------------------------------------------- |
| Scrum          | Sprint (Scrum): A fazer, Em andamento, Em revisão, Concluído                | 4 labels, 3 templates de card e a sprint "Sprint 1"        |
| Kanban simples | Kanban (Kanban): A fazer, Fazendo, Feito                                    | 3 labels e 1 template de card                              |
| Bugs/Suporte   | Suporte (Kanban): Novo, Triagem, Em correção, Aguardando cliente, Resolvido | 4 labels, campos Severidade e Cliente, 2 templates de card |
| Roadmap        | Roadmap (Kanban): Ideias, Próximo, Agora, Lançado                           | 4 labels, campos Trimestre e Impacto, 1 template de card   |

Os templates prontos aparecem no idioma da interface.

### Salvar um projeto como template

1. No projeto, vá em **Configurações → Geral** e clique em **Salvar como template**.
2. Confira o resumo em **Será copiado**: boards e colunas (com limite WIP), labels, campos customizados (com opções), templates de card e, se a primeira board for Scrum, uma sprint inicial "Sprint 1".
3. Dê um **Nome** (até 80 caracteres) e uma **Descrição** (até 500) e clique em **Salvar template**.

O template é uma cópia do momento. Mudanças posteriores no projeto não mudam o template, e vice-versa. Num projeto pessoal, o template vai para a sua biblioteca. Num projeto de organização, vai para a biblioteca da organização.

### Editor de templates

A biblioteca fica em:

- **Configurações** → **Templates de projeto** (`/settings/templates`), para os seus projetos pessoais;
- **Configurações da organização** → **Templates de projeto** (`/<organização>/settings/templates`), para os projetos da organização.

Para criar um template sem partir de um projeto, clique em **Novo template**, escolha em **Começar de** (**Em branco**, um template pronto ou um salvo) e clique em **Continuar**. O editor tem estas seções:

- **Geral**: nome, descrição e **Metodologia padrão**.
- **Boards e colunas**: até 20 boards, cada uma com metodologia e até 30 colunas. Use **Adicionar board** e **Adicionar coluna**, arraste as colunas para ordenar, marque as colunas **Concluído** e defina um **Limite WIP** se quiser.
- **Labels**: até 100, com nome e cor.
- **Campos customizados**: até 50, com as mesmas regras dos campos de um projeto.
- **Templates de card**: até 50. As labels deles vêm da lista de labels do template.
- **Sprint inicial**: ligue **Criar uma sprint inicial** e dê nome e **Objetivo**. Só vale quando a primeira board é Scrum.

Clique em **Criar template** ou em **Salvar alterações**. Editar um template não muda os projetos já criados com ele. Se outra pessoa salvou o template enquanto você editava, o editor avisa: **Recarregar** descarta as suas mudanças, e **Salvar por cima** grava a sua versão.

### Quem vê e quem edita

- Os templates pessoais são só seus.
- Na organização, quem tem **Criar projetos** ou **Gerenciar projetos** vê a biblioteca e cria templates. Quem criou o template e quem tem **Gerenciar projetos** editam e excluem. Os demais abrem o template só para leitura.
- Salvar um projeto como template exige **Gerenciar projeto** no projeto e o direito de criar projetos no dono (ser o dono, num projeto pessoal).

## Uso em outras partes do KrakenDock

- Helpdesk: os formulários usam os campos do projeto como **Campos extras** (até 20 por formulário, sem o tipo pessoa). Veja o [guia do Helpdesk](https://app.krakendock.com/docs/helpdesk).
- MCP: `get_project` lista os campos (com opções) e os templates de card. `create_card` aceita `template` (id ou nome) e `custom_fields` (por nome ou id do campo; seleção aceita o nome da opção). `update_card` altera valores, e `null` limpa um campo. Veja o [guia do MCP](https://app.krakendock.com/docs/mcp).
- Webhooks: o card de cada evento traz `custom_fields` com os valores preenchidos (id, nome, tipo, valor e as opções escolhidas). Em `card.updated`, a mudança de um campo aparece em `changes` como `custom_field`. Veja o [guia de webhooks](https://app.krakendock.com/docs/webhooks).

## Permissões

| Ação                                                   | Permissão necessária                           |
| ------------------------------------------------------ | ---------------------------------------------- |
| Ver campos e templates de card                         | **Ver projeto**                                |
| Preencher valores e criar cards com template           | **Editar cards**                               |
| Criar, editar e excluir campos e templates de card     | **Gerenciar projeto**                          |
| Salvar o projeto como template                         | **Gerenciar projeto** e criar projetos no dono |
| Ver e criar templates de projeto da organização        | **Criar projetos** ou **Gerenciar projetos**   |
| Editar e excluir um template de projeto da organização | ser o autor ou ter **Gerenciar projetos**      |

## Limites

|                                               | Free | Pro | Business |
| --------------------------------------------- | ---- | --- | -------- |
| Campos customizados por projeto               | 3    | 50  | 50       |
| Templates de card por projeto                 | 50   | 50  | 50       |
| Templates de projeto por conta ou organização | 50   | 50  | 50       |

- O limite de campos conta por projeto, conforme o plano do dono do projeto.
- Criar um projeto a partir de um template com mais campos do que o plano permite falha com `PLAN_LIMIT_REACHED`. Escolha outro template ou mude de plano.
- Os templates prontos cabem no plano Free.

Veja os planos em [https://app.krakendock.com/pricing](https://app.krakendock.com/pricing).

## Perguntas frequentes

### Por que não consigo mudar o tipo de um campo?

O tipo é fixo, porque os valores já gravados dependem dele. Crie um campo novo com o tipo certo, copie os valores e exclua o antigo.

### O campo obrigatório impede criar o card?

Não. O card é criado sem o valor e fica destacado até alguém preencher. Depois de preenchido, o valor só pode ser trocado.

### Mudei um template de card. Os cards antigos mudam?

Não. O template só age no momento da criação. O mesmo vale para os templates de projeto: editar ou excluir o template não mexe nos projetos criados com ele.

### Por que meu template não aparece no diálogo de card novo?

O diálogo mostra só os templates do tipo escolhido. Troque o **Tipo** do card. A criação rápida no rodapé da coluna também não usa templates (veja [Usar ao criar um card](#usar-ao-criar-um-card)).

### Por que não vejo meu template salvo ao criar um projeto?

A lista mostra os templates do dono escolhido. Um template pessoal não aparece num projeto da organização, e o contrário também. Na organização, você precisa de **Criar projetos** ou **Gerenciar projetos** (veja [Quem vê e quem edita](#quem-ve-e-quem-edita)).

### Baixei de plano e tenho mais campos do que o limite

Os campos existentes continuam funcionando. Você só não cria campos novos até ficar abaixo do limite.

## Veja também

- [Boards, cards e sprints](https://app.krakendock.com/docs/boards)
- [Primeiros passos](https://app.krakendock.com/docs/getting-started)
- [Helpdesk](https://app.krakendock.com/docs/helpdesk)
- [MCP](https://app.krakendock.com/docs/mcp)
- [Webhooks](https://app.krakendock.com/docs/webhooks)