Advanced Story Maps documentation

Common Issues & Questions

The Release button is not visible

You might be using a project where the Release feature is not enabled. Please go to the Project Administration -> Features and enable Releases.

The Sprint button is not visible

In team managed projects, it is possible that the Sprint feature is disabled. See above for the same problem with the Release feature. If you are using a Classic Project (or using Server or Data Center), the selected agile board might not support Sprints or you do not have Manage Sprints permission.

Sprint creation fails even though I have “Manage Sprints” permission

The selected agile board contains more than one project. You need to have Manage Sprints permission in all included projects.

Can not add issue to sprint, customfield_xxxxx can not be set

Make sure the sprint field is visible on the edit issue screen. If you created your project from a template that is not the scrum template, you need to add this field manually.

Issue appears in the story map but not in any Sprint swim lane in Sprint view

You might have had this issue in a previous sprint and that sprint was completed. Unfortunately, Jira does not clear the sprint field even when the issue is moved back to the backlog and / or is still in an open or in progress state. You need to manually reopen the old sprint and clear the field. See here for more info.

Can not add issue to release

If you have more than 1 project in your story map, you will see the release versions of all projects. But you can only assign the issues from one project to fixVersions of the same project. There is unfortunately nothing we can do about this.

If you want to plan cross-project releases, we recommend you use the custom swim lane or custom field mapping feature, available in Advanced Story Maps for Jira.

Could not update estimate

There are unfortunately several reasons for this:

  1. The configured board is a scrum board but the context for the story points field does not include the current issue type. See this community thread for further info.
  2. The configured board is a Kanban board or no board is configured and you have enabled the estimation feature via the settings - you need to make sure the story point field is available on the edit screen of the issue type.
  3. You entered an invalid value for the field. Story Mapping app will try to cast any value to a number and this operation can fail.