Skip to main content
Skip table of contents

The user story map: epics and items

What is the User story map?

The User story map displays items/issues from your Jira board in a “story map” format.

  • Epics as the backbone of the User story map

    • On Jira Cloud Premium/Enterprise, other epic-level items will also be in the backbone.

  • Story-level items underneath their parent epics as the body of the User story map

    • Items not assigned to an epic can be found in the “Issues without epics” panel.

User story map backbone and body annotated.png

Items are fetched directly from Jira on page load. Changes you make on the User story map are saved to Jira immediately.

Why use a story map?

“Story mapping” was coined by Jeff Patton as a way to describe a two-dimensional alternative to the “flag backlog”:

Building a user story map helps us focus on the big picture – the product as a whole instead of getting myopically focused on an individual story.

User story mapping is traditionally used at project inception to build a backlog for a new idea.

However, Easy Agile customers have found the tool useful for prioritisation, sprint planning, and backlog refinement.

By centring your plans around the user journey, you can keep your focus on the customer as you build new value for them.

https://www.youtube.com/watch?v=WZqG-l5w6Vc

Easy Agile co-founder Nick Muldoon has used user story mapping to help product teams at Atlassian and Twitter, before starting Easy Agile in 2015. Learn more about the process in The Ultimate Guide to User Story Mapping.

Create new items

You can quick-create issues between or beside existing issues.

User Story Map quick-create.gif

Your items will be created with fields set:

New items that do not match your board filter query may disappear from the User story map and Jira board. If your Jira board filter includes a simple field requirement, the app will attempt to set that field.

When your Jira project has additional required fields, Jira’s Create issue pop-up will show so you can complete the required fields. Learn more about field configuration in Jira Cloud or Jira Data Center.

Edit items

On the User story map, you can:

  • Inline-edit the item summary

  • Update the estimate

  • Create sub-tasks

Drag and drop items to:

  • Change the parent epic

  • Change the Sprint or Fix version

  • Re-rank items on the backlog

Click on the work item key to open the in-app item view to edit more fields.

  • Ctrl+click on Windows or (cmd+click on a Mac) on a work item key to open the full Jira item page in a new tab.

Customize the view

Use sprint or version swimlanes

On Scrum boards, enable Sprint swimlanes to plan work in sprints from your Jira board.

On single-project Jira boards, use Version swimlanes to visualise Releases / Fix Versions from your Jira project.

Learn more about sprint and version swimlanes.

Version swimlanes.png
JavaScript errors detected

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

If this problem persists, please contact our support.