Overview

GitLab for Confluence Cloud Overview

GitLab for Confluence Cloud allows teams to display GitLab content directly within Confluence pages, helping engineering, product, and operations teams collaborate more effectively without leaving Confluence.

The integration supports both GitLab SaaS and GitLab On-Premises deployments.

Features

GitLab for Confluence Cloud supports displaying:

• Projects

• Merge requests

• Issues/work items

• Pipelines

• Source Code

Using simple GitLab links, the app automatically renders rich previews directly within Confluence pages.

Supported GitLab Deployments

GitLab SaaS

The app fully supports GitLab SaaS using:

https://gitlab.com

GitLab On-Premises

GitLab On-Premises instances are also supported.

To use an On-Premises deployment, your GitLab instance must be accessible via a public internet URL so the integration can retrieve repository data securely.

How It Works

The integration uses a GitLab Personal Access Token (PAT) configured by a Confluence administrator.

Once configured:

1. Users insert GitLab links into the macro

2. The app retrieves GitLab metadata

3. Rich previews are displayed automatically in Confluence

Supported Link Types

The GitLab macro currently supports:

Getting Started

To start using GitLab for Confluence Cloud:

1. Install the app from the Atlassian Marketplace

2. Generate a GitLab Personal Access Token

3. Configure the GitLab connection

4. Insert GitLab links using the macro

For detailed setup instructions, see:

• Installation & Configuration

• Using the GitLab Macro

• Troubleshooting

Permissions

The integration requires a GitLab Personal Access Token with the appropriate permissions.

At minimum, the token should include:

• read_api

Additional permissions may be required depending on repository visibility and organizational policies.

Troubleshooting

If GitLab content does not load correctly, common causes include:

• Invalid or expired Personal Access Tokens

• Incorrect GitLab base URL

• Missing permissions

• Expired Marketplace license

See the Troubleshooting guide for more details.

Feedback and Support

We welcome feedback, feature requests, and bug reports.

Please contact us through our support portal for assistance.

Related Integrations

You may also be interested in our other Atlassian integrations:

• Jigit - GitHub, GitLab, Gerrit Integration for Jira
  Connect your source control and development activity to Jira issues for improved visibility and traceability.

• Advanced Microsoft Teams Connector for Confluence
  Integrate Confluence with Microsoft Teams to make documentation more accessible and improve team collaboration.

Updated: 27 May 2026