Confluence Workspace

{{< details >}}

• Tier: Free, Premium, Ultimate
• Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

Use a Confluence Cloud 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 the Maintainer or Owner 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. In the top bar, 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

{{< details >}}

• Offering: GitLab Self-Managed

{{< /details >}}

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. In the upper-right corner, select Admin.
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. In the top bar, select Search or go to and find your project.
2. Select Plan > Confluence.
3. Select Go to Confluence.