Help us learn about your current experience with the documentation. Take the survey.

Asana

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

The Asana integration adds commit messages as comments to Asana tasks. After you turn on the integration, commit messages are checked for Asana task URLs (for example, https://app.asana.com/1/12345/project/67890/task/987654) or task IDs starting with # (for example, #987654). Every task ID found gets the commit comment added to it.

You can also close a task with a message containing: fix #123456. You can use either of these words:

  • fix
  • fixed
  • fixes
  • fixing
  • close
  • closes
  • closed
  • closing

See also the Asana integration API documentation.

Setup

In Asana, create a personal access token. Learn about personal access tokens in Asana.

Complete these steps in GitLab:

  1. In the top bar, select Search or go to and find your project.
  2. In the left sidebar, select Settings > Integrations.
  3. Select Asana.
  4. Under Enable integration, select the Active checkbox.
  5. Paste the token you generated in Asana.
  6. Optional. To restrict this setting to specific branches, list them in the Restrict to branch field, separated with commas.
  7. Optional. Select Test settings.
  8. Select Save changes.