Managing discussions

You can categorize, spotlight, transfer, or delete the discussions.

Who can use this feature?

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

About management of discussions

GitHub Discussions is an open forum for conversation among maintainers and the community for a repository or organization on GitHub Enterprise Server. For more information about discussions, see "About discussions."

Organization owners can choose the permissions required to create a discussion in repositories owned by the organization. Similarly, to choose the permissions required to create an organization discussion, organization owners can change the permissions required in the source repository. For more information, see "Managing discussion creation for repositories in your organization."

As a discussions maintainer, you can create community resources to encourage discussions that are aligned with the overall project goal and maintain a friendly open forum for collaborators. Creating contribution guidelines for collaborators to follow will help facilitate a collaborative and productive forum. For more information on creating community resources, see "Setting guidelines for repository contributors."

When a discussion yields an idea or bug that is ready to be worked on, you can create a new issue from a discussion. For more information, see "Creating an issue."

You can pin a discussion to the top of the list of discussions for the repository or organization. You can also pin a discussion to a specific category. For more information, see "Managing discussions."

For more information on facilitating a healthy discussion, see "Moderating comments and conversations."

To organize discussions more granularly, you can apply labels. For example, you can use labels to indicate the status of a discussion to make triaging more efficient. Each repository has one shared set of labels for issues, pull requests, and discussions. For more information, see "Managing labels."

Prerequisites

To manage discussions in a repository, GitHub Discussions must be enabled for the repository. For more information, see "Enabling or disabling GitHub Discussions for a repository."

To manage discussions in an organization, GitHub Discussions must be enabled for the organization. For more information, see "Enabling or disabling GitHub Discussions for an organization."

Changing the category for a discussion

You can categorize discussions to help community members find related discussions. For more information, see "Managing categories for discussions."

You can also move a discussion to a different category. It's not possible to move a discussion to or from the polls category.

On your GitHub Enterprise Server instance, navigate to the main page of the repository.
Under your repository or organization name, click Discussions.
In the list of discussions, click the discussion you want to view.
In the right sidebar, to the right of "Category", click .
Click a category.

Pinning a discussion

You can pin a discussion above the list of discussions for the repository or organization. You can also pin a discussion to a specific category. The globally pinned discussions will be shown in addition to the discussions pinned to a specific category.

This is what it looks like when you have a globally pinned discussion and a discussion pinned to the Ideas category.

Screenshot of a globally pinned discussion and a discussion pinned to the Ideas category.