Mark up comments, issues, and commit messages

You can refer to a Bitbucket Cloud issues, requests, and users directly from a comment an issue or a commit message.  When you create a reference, saving the comment (or issue) causes Bitbucket to automatically link to that object.  You can also mention an individual or team account — even insert an emoji. The following Bitbucket markup is available:

For items that are repository-specific, such as issues, pull requests, and commits, references to Bitbucket objects always refer to the current repository.  For example, when commenting on a pull request in repoAlpha you can't link to an issue in repoBeta.  

If you want to add special formatting such as headings and code references, you can use any supported Markdown syntax in any comment.

Issue

Syntax : issue #number

Links to a given issue. Supports the following arguments:

Argument Description Required?
number The issue number Yes

You can also close or reopen issues by including specific keywords in your commit messages, for information about Resolve issues automatically when users push code.

Examples:

issue #88

Results in the following output:

issue #88

Pull request

Syntax : pull request #number

Links to a given pull request. Supports the following arguments:

Argument Description Required?
number The request number Yes

Examples:

pull request #1541

Results in the following output:

pull request #1541

Changeset

Syntax:  HEX_CHARS

Links to the given changeset. The system links any changeset hash automatically also.  Supports the following arguments:

Argument
Description
Required?
hashvalue A changeset hash. Yes

Examples:

9cc27f2

Account or Email

Syntax:  @accountname or @emailaddress

Links to the profile of the given accountname. Supports the following arguments:

Argument
Description
Required?
accountname or emailaddress The name of the individual or user account. Alternatively, you can supply an email address Yes

Examples:

@tutorials

@manthony@atlassian.com

Emoji

Syntax:  :emoji:

Displays the given emoji.  We don't have a definitive list of supported emoji; you'll need to just test the emoji you want to use. One of our users, David Coffey, created a list of available emoji

This syntax supports the following arguments:

Argument
Description
Required?
emoji The name of the emoji. Yes

Examples:

:mask:

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport