Skip to main content
Skip table of contents

Permissions

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

Easy Agile TeamRhythm leverages the permissions from the Agile Board which it sits on.

The minimum permission requirement to be able to access the app 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.

Can I disable the Retrospective page of Easy Agile TeamRhythm?

This is only available when using the app on Jira Data Center or Jira Server. Removing the app from the project sidebar is not currently possible on Jira Cloud.

Jira Administrator or System Administrator permission is required for this configuration.

This is only available from version 12.0.0 and later.

For DC or Server versions of the app, it is possible to remove all methods of navigating to the Retrospective page of Easy Agile TeamRhythm. This includes:

  • The Retrospective icon in the project sidebar; and

  • The Retrospective tab in the header of Easy Agile TeamRhythm (pictured).

In-app header tabs for User story map and Retrospective pages

To do this, find and disable the relevant app module(s). This is found in Jira’s global settings → Manage apps → Easy Agile TeamRhythm for JIRA → expand “### of ### modules enabled”:

  1. "Retrospective Navigation In App (eausm-enable-retrospective-in-app-navigation)”

  2. Retrospective in the global project nav (global-sidebar-plan-retrospective)”

  3. Retrospective (easy-agile-retrospective)”

Manage apps in Jira settings: the modules option

Is it possible to restrict the Easy Agile TeamRhythm app to certain Jira projects?

Once installed, the User story map and Retrospective icons will appear in the Project sidebar for every Jira software board:

On Jira Cloud

On Jira Data Center or Server

It is not possible to enable/disable the app on specific Jira projects or boards.

On Data Center and Server versions of the app, it is possible to hide one or both of the icons from the project sidebar in ALL Jira projects. See How do I remove the app icons from the Project sidebar? below.

Note that the app will only appear on Jira Software boards; it is not available for Business projects, Jira Work Management / Jira Core, or Jira Service Management.

Can I remove the app icons from the Project sidebar?

This is only available when using the app on Jira Data Center or Jira Server. Removing the app from the project sidebar is not currently possible on Jira Cloud.

Jira Administrator or System Administrator permission is required for this configuration.

If you wish for only some teams to use the Easy Agile TeamRhythm app, you may wish to remove the “User Story Map” and “Retrospective” icons from the project sidebar.

Because this will hide the app icons on all Jira projects, we recommend saving a link to the app pages for any projects where you do wish to use the app. We suggest adding a Project shortcut in Jira to the User Story Map and/or Retrospective page for each project where you wish to use the app.

To hide icons, find and disable the relevant app module(s). This is found in Jira’s global settings → Manage apps → Easy Agile TeamRhythm for JIRA → expand “### of ### modules enabled”:

To remove both “User Story Map” and “Retrospective” icons, disable the following modules:

  1. easy-agile-user-story-maps Icon css (eausm-icon)”

  2. Storymap in the global project nav (global-sidebar-plan-storymap)”

  3. Retrospective in the global project nav (global-sidebar-plan-retrospective)”

If you wish to remove only the Retrospective option, see Can I disable the Retrospective page of Easy Agile TeamRhythm? above.

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

This is only available when using the app on Jira Data Center or Jira Server.

Jira Administrator or System Administrator permission is required for this configuration.

The position of the Story Map 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:

HTML
<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>

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:

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

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.