Link to a web service

Links allows commit messages and pull request comments in Bitbucket Cloud to reference pages on external sites and services. These references typically take the form of hypertext links.

From the Links page, you can set up a link between Bitbucket and any external service. By default, we provide options for Jira, Bamboo Server, Crucible, and Jenkins, making it easy to link to any of those from Bitbucket.

When you set up links, they only work for adding links to pages in Bitbucket. To view commit messages within the external service, you'll need an add-on from the Atlassian Marketplace that provides the integration.

You might see three different type of links on this page:

  • Links you add from the Repository link dialog

  • Connect add-ons that appear automatically when you install one

To establish a link, you need to supply a server URL and a key. Then, you'll use that key and a value to create links on commit messages and pull request comments. If your commits or comments already include a key and value for service not yet linked, adding the service to the Links page makes them links.

  1. Next to the name of your repository in the left sidebar, select More actions (…), and then select Settings.

  2. Under Workflow on the left sidebar, select Links.

  3. Select Add new link.
    The Repository link dialog appears.

  4. Select the Link type. If you want to link Jira, Bamboo Server, Crucible, or Jenkins, select the appropriate option. Otherwise, select Custom.

  5. Enter the Link URL.
    For example, if you're linking to Jira, your URL may look like https://jira.atlassian.com.

  6. Enter the Link key. The key value is case sensitive.
    For example, if you're linking to a project in Jira with a key of BB, you'll enter BB for the key.

  7. Press Save.

To use the link once it's set up, you reference the Link key and a value from the service.

Still need help?

The Atlassian Community is here for you.