• Products
  • Documentation
  • Resources

Enable custom fields used in Advanced Roadmaps in Jira

This page refers to Advanced Roadmaps, which is a cross-project planning tool only available as part of Jira Software Cloud Premium and Enterprise.

We have a separate section for documentation about the project timeline that’s included in all Jira Software plans. Go to the documentation for project-level roadmaps in Jira Software.


Some default fields used in Advanced Roadmaps like Parent aren’t default fields in Jira Software. Outside of that, your organization might plan using custom date fields or labels. As such, most Jira administrators add at least one custom field to their Jira tickets when working with Advanced Roadmaps.

If you decide not to add them to your Jira issues but still use them in Advanced Roadmaps, you won’t be able to save values assigned to these fields to your issues.

Only globally-configured fields are available in Advanced Roadmaps; custom fields from team managed-projects aren’t yet supported.

The following custom field types are supported in Advanced Roadmaps:

Changes to teams in Jira Software and Advanced Roadmaps

The content on this page refers to the new Teams functionality which started rolling out in August 2023, and is still rolling out across Advanced Roadmaps. Learn more about the new Teams functionality in Advanced Roadmaps.

How do I know if my site has the new teams functionality?

If the Teams page mentions Shared teams anywhere, then the new feature hasn’t reached your site yet. Until that happens, content about shared teams in Advanced Roadmaps can be found on a separate page. Learn more about shared teams in Advanced Roadmaps.

Adding these fields is a two step process.

The processes described in this section are only possible with the Jira Software Administrator permissions.

1. Add custom fields to your Jira issues:

  1. Select > Issues.

  2. Under FIELDS, select Custom fields.

  3. Click Create custom field. Make sure to select All to view the available field options.

  4. Select the type of field you want to create and click Next. See a list and descriptions for the available custom field types in company-managed projects.

  5. Add the details for your field.

    The name you select appears as the custom field's title wherever the field appears. The description appears below the field when creating and editing issues, but not when browsing issues.

  6. When you have entered the field details, select Create.

  7. Add the new custom field to one or multiple screens by ticking the corresponding box and click Update.

Data in these custom fields will be saved to your Jira issues, but won’t be visible until the fields are added to your instance.

Optional: Once you’ve created your custom field, you can configure it have have a default value. Learn how to configure default values in custom fields in Jira.

2. Add custom field to issue scheme

  1. Select  > Issues.

  2. In the left menu, select Custom fields listed under Fields.

  3. Find your recently added field, then select > Associate to Screens.

  4. Select the appropriate screen(s), then scroll to the bottom and select Update.

Now that you’ve added the custom field to issues and the scheme, Advanced Roadmaps users can now add it to their plans. Learn how to add it to on the Add and view custom fields in Advanced Roadmaps page.

Grab some coffee, take a victory lap, and high-five someone. You’ve made it to the end!


Additional Help