What are the permission requirements to view/edit the Story Map?

Easy Agile User Story Maps leverages the permissions from the Agile Board which it sits on.

The minimum permission requirement to be able to access the Story Map is the Create Issues permission. If users do not have this permission, they will not be able to access the Story Map and will see an error message that reads Cannot detect Epic Issue type on load.

Learn how to enable the Create issues permission here.


Is it possible to restrict the Story Map to certain Projects?

Once installed, the Story Map icon will appear in the Project sidebar for every Agile Board. You are not able to restrict the visibility of the icon to select Projects/Boards.

If you would like to remove the Story Map icon from every project, see “How do I remove the User Story Maps icon from the Project Sidebar?” below.


How do I change the position of the User Story Maps icon in the Project sidebar?

This information only applies to Jira Server and Data Center. This configuration is only available to System Administrators.

The position of the User Story Maps icon can be changed by altering the script in the Announcement banner.

To move the icon to, in this example, below the Reports icon, add the following code snippet to the Announcement Banner:

<script type="text/javascript">
  $(function() {
    AJS
      .$("[data-link-id='com.atlassian.jira.jira-projects-plugin:report-page']")
      .parent()
      .after(
        AJS.$("[data-link-id='com.kretar.jira.plugin.user-story-map:easy-agile-story-map']")
        .parent()
      )
  });
</script>
HTML

If you're not actively using the announcement banner, we recommend also adding the following CSS style to hide the announcement banner as it otherwise unnecessarily bumps out whitespace at the top of every page:

<style>
  #announcement-banner {
    display: none;
  }
</style>
HTML


How do I remove the User Story Maps icon from the Project Sidebar?

The story map icon will only appear on Jira Software projects, not Jira Service Desk or Core.

For Jira Server and Data Center you can temporarily disable the module which shows the icon in the Project sidebar. Here are instructions on how to do this, under the Remove Icon from Project Sidebar heading. 

Unfortunately this is an on/off solution - disabling the module, will remove the icon entirely and you will need to create a Project shortcut to access any Story Maps. 

It is possible for a System Administrator to remove the Story Map icon from the project sidebar of every JIRA Software project. Before the icon is hidden a project administrator should add a project shortcut to the story map for each project that wishes to use Easy Agile User Story Maps.

To remove the icon a System Administrator must:

  1. Browse to Add-ons → Manage Add-ons

  2. Open Easy Agile User Story Maps for JIRA

  3. Expand '15 of 15 modules enabled'

  4. Click Disable next to the (eausm-icon) module