Include from GitHub to Confluence Cloud

Connect to GitHub Cloud (github.com)

Public repositories

No configuration needed.

Private repositories

By default no configuration is required. Each user will have to authenticate with OAuth to GitHub to access the content. Therefore, each Confluence user also needs a GitHub account to see the private repositories.

Shared Authentication

Alternatively, shared authentication can be used. All Confluence users will share the same authentication to GitHub and therefore won’t need a GitHub account. Confluence users will see all content the authentication token has access to.

  1. On github.com , navigate to

    1. User (top-right) → Settings → Developer settings → Personal access tokens → Fine-grained tokens

  2. Generate a new fine-grained token

    1. Select the Resource owner:

      • Choose your personal account or

      • Choose your organization (available if the organization allows fine-grained tokens)

    2. Select the repositories you want to grant access to

    3. Use the following permissions:

      • Contents: Read-only

      • Pull requests: Read-only

      • Issues: Read-only

    4. Set an expiration date

      image-20230915-121224.png


  3. On Confluence, navigate to the Settings → Apps → Include from GitHub to Confluence

  4. Switch the authentication method and save the token:

Include from GitHub - cloud configuration.png