Managing categories for discussions in your repository

About categories for discussions

GitHub Discussions is 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

Category	Purpose	Format
📣 Announcements	Updates and news from project maintainers	Announcement
#️⃣ General	Anything and everything relevant to the project	Open-ended discussion
💡 Ideas	Ideas to change or improve the project	Open-ended discussion
🙏 Q&A	Questions for the community to answer, with a question/answer format	Question and Answer
🙌 Show and tell	Creations, experiments, or tests relevant to the project	Open-ended discussion

Creating a category

1. On GitHub, navigate to the main page of the repository.
2. Under your repository name, click Discussions.
3. To the right of "Categories", click .
4. Click New category.
5. Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "About discussions."
6. Click Create.

Editing a category

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

1. On GitHub, navigate to the main page of the repository.
2. Under your repository name, click Discussions.
3. To the right of a category in the list, click .
4. Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "About discussions."
5. Click Save changes.

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, navigate to the main page of the repository.
2. Under your repository name, click Discussions.
3. To the right of a category in the list, click .
4. Use the drop-down menu, and choose a new category for any discussions in the category you're deleting.
5. Click Delete & Move.