Linear

{{< details >}}

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

{{< /details >}}

{{< history >}}

• Introduced in GitLab 18.3.

{{< /history >}}

You can use Linear as an external issue tracker. To enable the Linear integration in a project:

1. In the top bar, select Search or go to and find your project.

2. Select Settings > Integrations.

3. Select Linear.

4. Under Enable integration, select the Active checkbox.

5. Fill in the required fields:

   • Workspace URL: The URL to the Linear Workspace project to link to this GitLab project.

6. Optional. Select Test settings.

7. Select Save changes.

After you have configured and enabled Linear, you see the Linear link on the GitLab project pages, which takes you to your Linear workspace.

For example, this is a configuration for a workspace named example:

• Workspace URL: https://linear.app/example

You can also disable GitLab internal issue tracking in this project. For more information about the steps and consequences of disabling GitLab issues, see Configure project visibility, features, and permissions.

Reference Linear issues in GitLab

You can reference your Linear issues using:

• <TEAM>-<ID>, for example API-123, where:
  • <TEAM> is a team identifier
  • <ID> is a number.