Asana
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
The Asana integration adds commit messages as comments to Asana tasks.
Once enabled, commit messages are checked for Asana task URLs (for example,
https://app.asana.com/0/123456/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:
- On the left sidebar, select Search or go to and find your project.
- Select Settings > Integrations.
- Select Asana.
- Ensure that the Active toggle is enabled.
- Paste the token you generated in Asana.
- Optional. To restrict this setting to specific branches, list them in the Restrict to branch field, separated with commas.
- Optional. Select Test settings.
- Select Save changes.
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support