Display additional information with User property custom field in Jira Cloud

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Summary

Learn how to use Jira user properties to display user details (such as phone and department) in work items, using a Property custom field.

Solution

Add properties to a user profile

  1. Go to your site's User management (<sitename>.atlassian.net/admin/users).

  2. Click the profile of the user that you want to add properties.

  3. Next to the Jira product, click More actions (•••) > Edit Jira properties.

  4. Add the values for Key and Value, and click Add.

  5. Repeat these steps for all the relevant users.

These user properties are not the same as the user properties accessed via REST API. Bulk-adding Jira user properties is not possible.

Create a custom field to display a property in the work item view

  1. Go to Settings > Work Items > Custom fields.

  2. Click to Create custom field > Advanced.

  3. Select User Property Field (< 255 characters) > Next > Add a name > Create.

  4. Select the screens you want this field to be visible on and click Update.

  5. Find the field, and click More actions (•••) > Contexts and default value.

  6. Edit Default Value:

    1. The formatting should be <fieldname>:<user property name>. For example, to fetch the "Department" user property from the user on the Reporter field, it should be Reporter:Department.

  7. Confirm by clicking Set default.

  8. Repeat the steps to create multiple fields for each property.

For example, you set up a Jira user property called "Department." Then, you create a field for the property and set the default value to Reporter:Department. Let’s say John works in the Sales department. Whenever John creates a work item, the "Department" field will automatically show "Sales."

Updated on May 23, 2025

Still need help?

The Atlassian Community is here for you.