Managing discussions in your repository

You can categorize, spotlight, transfer, or delete the discussions in a repository.

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

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

About management of discussions

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

Organization owners can choose the permissions required to create a discussion for repositories owned by the organization. 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 a code of conduct or contribution guidelines for collaborators to follow will help facilitate a collaborative and productive forum. For more information on creating community resources, see "Adding a code of conduct to your project," and "Setting guidelines for repository contributors."

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."

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 in your repository."

You can also move a discussion to a different category.

  1. On GitHub, navigate to the main page of the repository.
  2. Under your repository name, click Discussions. "Discussions" tab for a repository
  3. In the list of discussions, click the discussion you want to view. Discussion in list of discussions for a repository
  4. In the right sidebar, to the right of "Category", click . "Category" with gear icon
  5. Click a category. "Change category" drop-down menu

Pinning a discussion

You can pin up to four important discussions above the list of discussions for the repository.

  1. On GitHub, navigate to the main page of the repository.
  2. Under your repository name, click Discussions. "Discussions" tab for a repository
  3. In the list of discussions, click the discussion you want to view. Discussion in list of discussions for a repository
  4. In the right sidebar, click Pin discussion. "Pin discussion" in right sidebar for discussion
  5. Optionally, customize the look of the pinned discussion. Customization options for a pinned discussion
  6. Click Pin discussion. "Pin discussion" button under customization options for pinned discussion

Editing a pinned discussion

Editing a pinned discussion will not change the discussion's category. For more information, see "Managing categories for discussions in your repository."

  1. On GitHub, navigate to the main page of the repository.
  2. Under your repository name, click Discussions. "Discussions" tab for a repository
  3. In the list of discussions, click the discussion you want to view. Discussion in list of discussions for a repository
  4. In the right sidebar, click Edit pinned discussion. "Pin discussion" in right sidebar for discussion
  5. Customize the look of the pinned discussion. Customization options for a pinned discussion
  6. Click Pin discussion. "Pin discussion" button under customization options for pinned discussion

Unpinning a discussion

  1. On GitHub, navigate to the main page of the repository.
  2. Under your repository name, click Discussions. "Discussions" tab for a repository
  3. In the list of discussions, click the discussion you want to view. Discussion in list of discussions for a repository
  4. In the right sidebar, click Unpin discussion. "Unpin discussion" in right sidebar for discussion
  5. Read the warning, then click Unpin discussion. "Unpin discussion" button beneath warning in modal

Transferring a discussion

To transfer a discussion, you must have permissions to create discussions in the repository where you want to transfer the discussion.

  1. On GitHub, navigate to the main page of the repository.
  2. Under your repository name, click Discussions. "Discussions" tab for a repository
  3. In the list of discussions, click the discussion you want to view. Discussion in list of discussions for a repository
  4. In the right sidebar, click Transfer discussion. "Transfer discussion" in right sidebar for discussion
  5. Select the Choose a repository drop-down, and click the repository you want to transfer the discussion to. "Choose a repository" drop-down, "Find a repository" search field, and repository in list
  6. Click Transfer discussion. "Transfer discussion" button

Deleting a discussion

  1. On GitHub, navigate to the main page of the repository.
  2. Under your repository name, click Discussions. "Discussions" tab for a repository
  3. In the list of discussions, click the discussion you want to view. Discussion in list of discussions for a repository
  4. In the right sidebar, click Delete discussion. "Delete discussion" in right sidebar for discussion
  5. Read the warning, then click Delete this discussion. "Delete this discussion" button beneath warning in modal

Converting issues based on labels

You can convert all issues with the same label to discussions in bulk. Future issues with this label will also automatically convert to the discussion and category you configure.

  1. On GitHub, navigate to the main page of the repository.

  2. Under your repository name, click Issues.

    Issues tab

  3. Above the list of issues or pull requests, click Labels. Labels tab on a repository's issues or pull requests page

  4. Next to the label you want to convert to issues, click Convert issues.

  5. Select the Choose a category drop-down menu, and click a category for your discussion.

  6. Click I understand, convert this issue to a discussion.

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

Or, learn how to contribute.