robotsnoindex
robotsnoindex
robotsnoindex

The following smart values are available to access and format user data when setting up a rule.

User properties

The following properties are accessible for all user smart values:

  • accountId: the unique ID of the user, set by Jira. It is not possible to change this ID. Learn more about converting usernames to user account IDs.

  • active: whether the user's account is active or not

  • avatarUrls: provides access to the user's avatar images in sizes 16x16, 24x24, 32x32 & 48x48

  • displayName: the full name in the user's profile

  • emailAddress: the email address in the user's profile

  • timeZone : the time zone based on the location set in the user's profile.

Examples

{{creator.displayName}}
{{comment.author.displayName}}
{{reporter.emailAddress}}
{{assignee.timeZone}}
{{assignee.accountId}}
{{assignee.avatarUrls."48x48"}}

{{assignee}}

The assignee of the active issue.

{{assignee.displayName}}

{{comment.author}}

The user who adds a comment on an issue.

{{comment.author.displayName}}

{{creator}}

The user who created the active issue. It is not possible to change the creator of an issue.

{{creator.displayName}}

{{initiator}}

The user who triggered the rule.

{{initiator.displayName}}

{{reporter}}

The reporter of the active issue.

{{reporter.displayName}}

{{Custom field}}

To access information related to user picker custom fields, enter the field name in between {{ and }}. For example, if you have a custom field called Squad leader and you want to access the display name for that user:

{{Squad leader.displayName}}

How to mention another user

Mention a specific user

To @mention another user in an automation rule, you'll need their account ID. You can find their account ID by visiting their profile and looking at the end of the URL. 

You'll then need to enter the following:

[~accountId:their account ID]


Mention a user in a field

To @mention the person in a particular field, for example the issue's Assignee, enter the following:

[~accountId:{{user field name.accountId}}]


Mention a user in Slack

You can build automation rules that mention people and send direct messages to people in Slack. Learn more about using automation with Slack.


Example

To mention a specific person:

[~accountId:557057:1d4fd7f4-b1ac-4466-82ee-b50a95b3szx93]

// returns

@Alana Grant


To write a comment that mentions the assignee:

Hey [~accountid:{{assignee.accountId}}], just a reminder to please check your estimates before the next sprint.

//returns

Hey @Alana Grant, just a reminder to please check your estimates before the next sprint.


If you have a user custom field called Squad leader and you want to mention them:

Hi [~accountid:{{Squad leader.accountId}}], could you please assign this bug to someone on your team?

//returns

Hi @Alana Grant, could you please assign this bug to someone on your team?


Entity Properties

Entity properties are arbitrary key/value pairs that can be set for a user in Jira. Users have 2 types of entity properties available:

{{reporter.properties}}

// e.g. if 'financeAccountId' is an entity property set 
//  programmatically by another app
{{reporter.properties.financeAccountId}}

Entity properties can only be set via API calls using the /rest/api/3/user/properties REST API.