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 |
|
State (Open / Answered / Closed), title, number, category (with emoji), author, labels, comment count |
|
Discussions list |
|
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 linksor 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:
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."
If you see a permission error, contact your Confluence administrator to approve the Discussions permission on the GitHub App installation.
For a full overview of GitHub App permissions and how to manage organisation access, see Managing GitHub App permissions and organisation access.
Updated: