Skip to main content

Managing categories for discussions

You can categorize discussions to organize conversations for your community members, and you can choose a format for each category.

Who can use this feature

Repository administrators and people with write or greater access to a repository can manage categories for discussions in the repository. Repository administrators and people with write or greater access to the source repository for organization discussions can manage categories for discussions in the organization.

About categories for discussions

O GitHub Discussions é um fórum aberto para conversa entre mantenedores e a comunidade de um projeto no GitHub. Todas as discussões devem ser criadas em uma categoria. Para discussões do repositório, as pessoas com permissões de manutenção ou administrador no repositório definem as categorias para discussões nesse repositório. Para discussões da organização, as pessoas com permissões de manutenção ou administrador no repositório de origem definem as categorias para discussões nessa organização. Cada categoria tem um formato: discussão aberta, pergunta e resposta ou anúncio.

Os mantenedores podem usar categorias com o formato do anúncio para compartilhar informações, versões ou eventos. Para manter as discussões nessas categorias focadas em atualizações importantes, apenas pessoas com permissões de manutenção ou administração podem criar novas discussões, mas qualquer pessoa pode comentar e responder.

Each category must have a unique name and emoji pairing, and can be accompanied by a detailed description stating its purpose. Categories help maintainers organize how conversations are filed and are customizable to help distinguish categories that are Q&A or more open-ended conversations. Cada repositório ou organização pode ter até 25 categorias. For more information, see "About discussions."

Default categories

CategoryPurposeFormat
📣 AnnouncementsUpdates and news from project maintainersAnnouncement
#️⃣ GeneralAnything and everything relevant to the projectOpen-ended discussion
💡 IdeasIdeas to change or improve the projectOpen-ended discussion
🗳 PollsPolls with multiple options for the community to vote for and discussPolls
🙏 Q&AQuestions for the community to answer, with a question/answer formatQuestion and Answer
🙌 Show and tellCreations, experiments, or tests relevant to the projectOpen-ended discussion

Creating a category

  1. On GitHub.com, navigate to the main page of the repository or organization where you want to create a category.
  2. No nome de seu repositório ou organização, clique em Discussões. Guia "Discussões" de um repositório
  3. À direita das "Categorias", clique em . Ícone de lápis para edição de categorias
  4. Click New category. "New category" button above list of discussion categories for a repository
  5. Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "About discussions." Emoji, title, description, and discussion format for new category
  6. Click Create. "Create" button for new category

Editing a category

You can edit a category to change the category's emoji, title, description, and discussion format.

  1. On GitHub.com, navigate to the main page of the repository or organization where you want to edit a category.
  2. No nome de seu repositório ou organização, clique em Discussões. Guia "Discussões" de um repositório
  3. To the right of a category in the list, click . Edit button to the right of category in list of categories for a repository
  4. Edite o emoji, título, descrição e formato de discussão para a categoria. Para obter mais informações sobre os formatos de discussão, confira "Sobre as discussões". Editing emoji, title, description, and discussion format for existing category
  5. Click Save changes. "Save changes" button for existing category

Deleting a category

When you delete a category, GitHub will move all discussions in the deleted category to an existing category that you choose.

  1. On GitHub.com, navigate to the main page of the repository or organization where you want to delete a category.
  2. No nome de seu repositório ou organização, clique em Discussões. Guia "Discussões" de um repositório
  3. To the right of a category in the list, click . Trash button to the right of category in list of categories for a repository
  4. Use the drop-down menu, and choose a new category for any discussions in the category you're deleting. Drop-down menu for choosing new category when deleting an existing category
  5. Click Delete & Move. Drop-down menu for choosing new category when deleting an existing category