Pivotal Tracker
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
The Pivotal Tracker integration adds commit messages as comments to Pivotal Tracker stories.
Once enabled, commit messages are checked for square brackets containing a hash mark followed by
the story ID (for example, [#555]
). Every story ID found gets the commit comment added to it.
You can also close a story with a message containing: fix [#555]
.
You can use any of these words:
fix
fixed
fixes
complete
completes
completed
finish
finished
finishes
delivers
Read more about the Source Commits endpoint in the Pivotal Tracker API documentation.
See also the Pivotal Tracker integration API documentation.
Set up Pivotal Tracker
In Pivotal Tracker, create an API token.
Complete these steps in GitLab:
- On the left sidebar, select Search or go to and find your project.
- Select Settings > Integrations.
- Select Pivotal Tracker.
- Ensure that the Active toggle is enabled.
- Paste the token you generated in Pivotal Tracker.
- 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