Os campos de problemas aparecem na barra lateral direita dos problemas, ao lado de campos do sistema como responsáveis, etiquetas e tipo. Você pode definir valores ao criar ou editar um problema. Quando você seleciona um tipo de problema ao criar um problema, todos os campos fixados nesse tipo aparecem automaticamente na barra lateral.
Observação
Os campos dos itens estão disponíveis atualmente apenas nos itens. As solicitações de pull não dão suporte a campos de problema.
Definindo um valor de campo
- Navegue até o problema que você deseja atualizar.
- Na barra lateral direita, se o campo desejado ainda não estiver visível, clique em Adicionar campo.
- No menu suspenso, selecione o campo que deseja adicionar.
- Defina o valor:
- Para campos de seleção única, escolha uma das opções na lista suspensa.
- Para campos de texto , digite seu valor. As URLs são detectadas e exibidas automaticamente como links.
- Para **** campos numéricos, insira um valor numérico.
- Para campos de data , use o seletor de datas para selecionar uma data ou digite a data diretamente.
- As alterações são salvas automaticamente.
Observação
Atualmente, os campos de problema não podem ser preenchidos previamente por meio de parâmetros de consulta de URL ou definidos por meio de modelos de problema. Para definir valores de campo, use a barra lateral do problema, projetos, a API ou GitHub Actions.
Editando um valor de campo
- Acesse o problema.
- Na barra lateral direita, clique no valor do campo que você deseja alterar.
- Selecione um novo valor ou digite uma nova entrada.
- As alterações são salvas automaticamente.
Limpar um valor de campo
- Acesse o problema.
- Na barra lateral direita, clique no valor do campo.
- Limpe o valor:
- Para campos de seleção única , clique na opção selecionada no momento para desmarcá-la.
- Para campos de texto e número , exclua todo o texto na entrada.
- Para campos de data, clique no botão 'Limpar' no seletor de data.
- Após limpar, o campo é removido da barra lateral. Ele pode ser adicionado novamente usando o botão Adicionar campo .
Campos fixados
Se os campos tiverem sido fixados em um tipo de problema específico pelo administrador da sua organização ou por você para seus repositórios de propriedade do usuário, esses campos aparecerão automaticamente na barra lateral e no modal de criação de problemas ao criar ou exibir um problema desse tipo. Você não precisa adicionar campos fixados manualmente.
Visualizando alterações de campo no cronograma
Quando um valor de campo é alterado, a atualização é registrada na linha do tempo do problema. A linha do tempo mostra:
- Qual campo foi alterado
- O novo valor que foi definido
- Quem fez a alteração
- O momento em que a alteração foi feita
Eventos de linha do tempo para campos definidos como visibilidade "Restrita" são visíveis apenas para membros da organização e colaboradores de repositório em repositórios de propriedade da organização ou para o proprietário do repositório e colaboradores em repositórios de propriedade do usuário.
Visibilidade do campo
Os administradores da organização e os proprietários da conta de usuário podem definir a visibilidade de cada campo como "Restrito" ou "Público". Isso afeta o que você vê:
- Se um campo for definido como Restrito, ele só ficará visível para membros da organização e colaboradores de repositório com pelo menos acesso de leitura em repositórios de propriedade da organização ou para o proprietário do repositório e colaboradores com pelo menos acesso de leitura em repositórios de propriedade do usuário. Se você não tiver acesso ao campo, ele não aparecerá na barra lateral do problema, na linha do tempo ou nas sugestões de pesquisa.
- Se um campo for definido como Público, ele ficará visível para qualquer pessoa que esteja exibindo o problema.
Para obter mais informações sobre como configurar a visibilidade, consulte Gerenciando campos de problema.
Usando campos de problema em projetos
Os campos de problema podem ser adicionados como colunas em exibições de projeto, em que você pode editar valores, agrupar, filtrar, classificar e compilar gráficos. Para obter mais informações, consulte Sobre campos de problema em projetos.
Pesquisando por valores de campo
Você pode filtrar e pesquisar problemas com base em valores de campo no painel de problemas e na página de problemas do repositório. Na barra de pesquisa, digite field. seguido pelo nome e valor do campo. Por exemplo:
field.priority:highpara encontrar problemas com a prioridade definida como "alta"field."target date":>=2026-03-01para encontrar problemas com uma data de destino em ou após 1º de março de 2026field.priority:high,mediumpara encontrar problemas com a prioridade definida como "alta" ou "média"
Para obter mais informações, consulte Filtrando e pesquisando problemas e pull requests.
Usando campos de problemas com a API
Os campos de problema têm suporte completo à API REST e GraphQL. Você pode automatizar o gerenciamento de campos, definir valores programaticamente e integrar-se a ferramentas externas.
- Gerenciando campos: criar, atualizar e excluir campos. Consulte a API REST dos campos de issue.
- Usando campos: obter, definir e limpar valores de campo em problemas individuais. Consulte a API REST de valores de campos de problemas.
- GraphQL: tipos de campo de problema e mutações também estão disponíveis por meio do GraphQL. Consulte a
IssueFieldsunião, os objetos de campo de emissão (comoIssueFieldText,IssueFieldSingleSelect,IssueFieldNumbereIssueFieldDate), e as mutações (comocreateIssueField,updateIssueFieldesetIssueFieldValue).
Automatizando com GitHub Actions
Alterações de campo de problema disparam eventos de webhook no issues evento. Você pode usá-los como gatilhos de fluxo de trabalho:
field_added: é acionado quando um valor de campo é definido ou atualizado.field_removed: é acionado quando um valor de campo é desmarcado.
Por exemplo, para executar um fluxo de trabalho sempre que um valor de campo for alterado:
on:
issues:
types: [field_added, field_removed]
O conteúdo do evento inclui o nome do campo, o tipo, o valor e o valor anterior. Para obter mais informações, consulte Eventos que disparam fluxos de trabalho.