• Set up the integration
  • For your project or all projects in a group
  • For all projects on the instance
• Access your Confluence Workspace from GitLab

Confluence Workspace

Use a Confluence Workspace as your project wiki.

This integration adds a link to a Confluence wiki instead of the GitLab wiki. Any content you have in Confluence is not displayed in GitLab.

When you turn on the integration:

• A new menu item is added to the left sidebar: Plan > Confluence. It links to your Confluence wiki.

• The Plan > Wiki menu item is hidden.

  To access the GitLab wiki for the project, use its URL: <example_project_URL>/-/wikis/home. To bring back the Plan > Wiki menu item, turn off this integration.

Creating a more comprehensive integration with Confluence Cloud is tracked in epic 3629.

Set up the integration

This integration can be turned on for a project or for all projects in a group or instance.

For your project or all projects in a group

Prerequisites:

• You must have at least the Maintainer role for the project.
• You must use a Confluence Cloud URL (https://example.atlassian.net/wiki/).

To set up the integration for your project or group:

1. On the left sidebar, select Search or go to and find your project or group.
2. Select Settings > Integrations.
3. Next to Confluence Workspace, select Configure.
4. Under Enable integration, select the Active checkbox.
5. In Confluence Workspace URL, enter your Confluence Workspace URL.
6. Select Save changes.

If the integration has been turned on for the group, you can still turn it off for individual projects.

For all projects on the instance

Prerequisites:

• You must have administrator access to the instance.
• You must use a Confluence Cloud URL (https://example.atlassian.net/wiki/).

To set up the integration for your instance:

1. On the left sidebar, at the bottom, select Admin Area.
2. Select Settings > Integrations.
3. Next to Confluence Workspace, select Configure.
4. Under Enable integration, select the Active checkbox.
5. In Confluence Workspace URL, enter your Confluence Workspace URL.
6. Select Save changes.

Access your Confluence Workspace from GitLab

Prerequisites:

• You must set up the integration for your project, group, or for your instance.

To access your Confluence Workspace from a GitLab project:

1. On the left sidebar, select Search or go to and find your project.
2. Select Plan > Confluence.
3. Select Go to Confluence.