Working with Discussions

The GitHub Links macro can display GitHub Discussions directly in Confluence - both individual discussions and filtered discussion lists.

Supported Discussion link types

Link type	URL pattern	What is displayed
Single discussion	`.../discussions/{number}`	State (Open / Answered / Closed), title, number, category (with emoji), author, labels, comment count
Discussions list	`.../discussions`	List of discussions with state, title, category, author

How to embed a discussion

Paste any GitHub Discussion URL directly onto a Confluence page in edit mode - it auto-converts to a card. You can also use the macro editor:

Type /GitHub links or click + and select GitHub links.
In the GitHub Link field, paste the discussion URL.
Click Submit.

Filtering a discussions list by category

Append a category query parameter to show only discussions from a specific category:

CODE

https://github.com/{owner}/{repo}/discussions?discussions_q=category:{category-name}

The macro renders only discussions in that category, with the category name as the section heading.

Permission requirements

Displaying discussions requires the Discussions (read) permission to be granted to the GitHub App. Without it the macro displays: "Additional GitHub App permission required - grant 'Discussions' (read) and re-approve the app to display discussions."

How to grant the Discussions permission

A Confluence administrator must complete this in GitHub:

Go to your GitHub organisation settings.
Navigate to Integrations → GitHub Apps.
Locate Links for Confluence and click Configure.
Scroll to the Permissions section.
Find Discussions and set it to Read.
Click Save. GitHub will prompt organisation members to re-approve the updated permissions.

Once re-approved, discussions will render correctly for all users.

For a full overview of GitHub App permissions and how to manage organisation access, see Managing GitHub App permissions and organisation access.

Updated: 12 Jun 2026