Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Managing categories for discussions in your repository

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

Repository administrators and people with write or greater access to a repository can enable discussions in the repository.

En este artículo

Note: GitHub Discussions is currently in beta and subject to change.

About categories for discussions

Discussions are an open forum for conversation among maintainers and the community for a project on GitHub. All discussions must be created in a category. People with maintain or admin permissions define the categories for a repository. Each category has a format: open-ended discussion, question and answer, or announcement.

Maintainers can use categories with the announcement format to share information, releases, or events. To keep discussions in these categories focused on important updates, only people with maintain or admin permissions can create new discussions, but anyone can comment and reply.

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. Each repository can have up to 10 categories. 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
🙏 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. En GitHub, visita la página principal del repositorio.
  2. Under your repository name, click Discussions. "Discussions" tab for a repository
  3. To the right of "Categories", click . Pencil icon for editing categories
  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. En GitHub, visita la página principal del repositorio.
  2. Under your repository name, click Discussions. "Discussions" tab for a repository
  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. Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "About discussions." 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. En GitHub, visita la página principal del repositorio.
  2. Under your repository name, click Discussions. "Discussions" tab for a repository
  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

Did this doc help you? Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.