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, and repository administrators and maintainers define the categories for a repository. Categories can contain open-ended conversations, or conversations with a question/answer format.
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 | Type |
|---|---|---|
| #️⃣ 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
- On GitHub, navigate to the main page of the repository.
- Under your repository name, click Discussions.
- To the right of "Categories", click .
- Click New category.
- Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "About discussions."
- Click Create.
Editing a category
You can edit a category to change the category's emoji, title, description, and discussion format.
- On GitHub, navigate to the main page of the repository.
- Under your repository name, click Discussions.
- To the right of a category in the list, click .
- Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "About discussions."
- 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.
- On GitHub, navigate to the main page of the repository.
- Under your repository name, click Discussions.
- To the right of a category in the list, click .
- Use the drop-down menu, and choose a new category for any discussions in the category you're deleting.
- Click Delete & Move.
