Skip to main content

Filtros da caixa de entrada

Saiba mais sobre como filtrar notificações na caixa de entrada do GitHub.

Você pode criar filtros personalizados para sua caixa de entrada usando os filtros com suporte a seguir. Para obter mais informações sobre como criar filtros personalizados, confira Gerenciamento de notificações da sua caixa de entrada.

Limitações de filtro personalizadas

Filtros personalizados atualmente não suportam:

  • Pesquisa de texto completo em sua caixa de entrada, incluindo busca de pull request ou títulos de problema.
  • Distinção entre os filtros de consulta is:issue, is:pr e is:pull-request. Essas consultas retornarão problemas e pull requests.
  • Criando mais de 15 filtros personalizados.
  • Alterando os filtros padrão ou sua ordenação.
  • Exclusão de pesquisa usando NOT ou -QUALIFIER.

Consultas suportadas para filtros personalizados

Estes são os tipos de filtros que você pode usar:

  • Filtrar por repositório com repo:
  • Filtrar por tipo de discussão com is:
  • Filtrar por motivo de notificação com reason:
  • Filtrar por autor de notificação com author:
  • Filtrar por organização com org:

Consultas repo: com suporte

Para adicionar um filtro repo:, você deve incluir o proprietário do repositório na consulta: repo:owner/repository. Um proprietário é a organização ou o usuário que possui o ativo de GitHub que aciona a notificação. Por exemplo, repo:octo-org/octo-repo mostrará notificações disparadas no repositório octo-repo dentro da organização octo-org.

Consultas is: com suporte

Para filtrar notificações para atividades específicas no GitHub, você pode usar a consulta is. Por exemplo, para ver apenas as atualizações de convites do repositório, use is:repository-invitation, e para ver somente Dependabot alerts, use is:repository-vulnerability-alert.

  • is:check-suite
  • is:commit
  • is:gist
  • is:issue-or-pull-request
  • is:release
  • is:repository-invitation
  • is:repository-vulnerability-alert
  • is:repository-advisory
  • is:discussion

Para obter informações sobre como reduzir as notificações desnecessárias do Dependabot alerts, confira Configurando notificações para alertas do Dependabot.

Você também pode usar a consulta is: para descrever como a notificação passou pela triagem.

  • is:saved
  • is:done
  • is:unread
  • is:read

Consultas reason: com suporte

Para filtrar as notificações por que você recebeu uma atualização, você pode usar a consulta reason:. Por exemplo, para ver as notificações quando você (ou uma equipe em que você está) é solicitado a examinar uma solicitação de pull, use reason:review-requested. Para saber mais, confira Sobre notificações.

ConsultaDescrição
reason:assignQuando houver uma atualização em um problema ou numa pull request que você tenha sido designado responsável.
reason:authorQuando você abriu uma pull request ou um problema e houve uma atualização ou novo comentário.
reason:commentQuando você adicionou um comentário a um issue ou um pull request.
reason:participatingQuando você adicionou um comentário em um issue ou pull request ou quando foi @mentioned.
reason:invitationQuando você for convidado para uma equipe, organização ou repositório.
reason:manualAo clicar em Assinar em um problema ou solicitação de pull que você ainda não foi inscrito.
reason:mentionVocê foi diretamente @mentioned.
reason:review-requestedVocê ou uma equipe da qual é integrante é solicitado a revisar uma pull request.
reason:security-alertQuando um alerta de segurança é emitido para um repositório.
reason:state-changeQuando o estado de uma pull request ou um problema é alterado. Por exemplo, um problema é fechado ou uma pull request é mesclada.
reason:team-mentionQuando uma equipe da qual você é membro é @mentioned.
reason:ci-activityQuando um repositório tem uma atualização de CI, como um novo status de execução de fluxo de trabalho.

Consultas author: com suporte

Para filtrar notificações por usuário, você pode usar a consulta author:. Um autor é o autor original da conversa (por exemplo: em um problema, pull request, gist ou discussão) da qual você está sendo notificado. Por exemplo, para ver as notificações para threads criados pelo usuário Octocat, use author:octocat.

Consultas org: com suporte

Para filtrar notificações por organização, você pode usar a consulta org. A organização que você precisa especificar na consulta é a organização do repositório, para a qual você está sendo notificado em GitHub. Esta consulta é útil se você pertencer a várias organizações e desejar ver as notificações para uma organização específica.

Por exemplo, para ver as notificações da organização octo-org, use org:octo-org.

Filtros personalizados de Dependabot

Se você usar o Dependabot para manter suas dependências atualizadas, poderá usar e salvar estes filtros personalizados:

  • is:repository_vulnerability_alert para mostrar notificações para Dependabot alerts.
  • reason:security_alert para mostrar notificações para Dependabot alerts e solicitações de pull de atualização de segurança.
  • author:app/dependabot para mostrar notificações geradas por Dependabot. Isto inclui Dependabot alerts, pull requests para atualizações de segurança e pull requests para atualizações de versão.

Para obter mais informações sobre o Dependabot, confira Sobre alertas do Dependabot.