Documentation

How to use Slicewise

Slicewise adds a story map tab to Jira software projects: company-managed and team-managed, Scrum and Kanban. Start with the short videos, or jump to a topic.

Videos have captions and voice. Music: "Easy Lemon" by Kevin MacLeod (incompetech.com), licensed under CC BY 4.0 (opens in a new tab).

Open the map

Open a Jira software project and click the Slicewise tab in the row of tabs at the top (Summary, Timeline, Backlog, …). If you don't see it, click More at the end of that row.

Read the map

  • Each column is an epic, in Jira's order. The coloured bar on top is the epic's Jira colour.
  • Cards are stories (and tasks, bugs — anything that can sit under an epic), in Jira's order.
  • The last column, No epic, holds stories without an epic.
  • A card shows the name, type and key, and can also show the status (when in progress or done), story points and the assignee's initials.
  • The top line counts epics and stories. Show done also shows finished work.

Rows: sprints or releases

  • None — one row.
  • Sprints — one row per open sprint, then Backlog. If the project has several boards, pick one with Board. Kanban boards have no sprints. If Jira cannot read a board, the map says so and you can pick another.
  • Releases — one row per release that is not released yet, then No release.
Slicewise with sprint rows and the label filter set to mobile, in the dark theme.
Sprint rows with a label filter, dark theme.

Move things

  • Drag a card to another epic, row or position. A line shows where it will land. Jira is updated at once.
  • Drag an epic (its header) left or right to change the epic order.
  • Keyboard: press Tab until a card is outlined, press M, choose where, press Enter. Or point at a card and click Move.
  • If Jira refuses a change, the map puts everything back and says why. Nothing is left half-changed.
  • If a kind of change is not possible for you in this project, a box at the top — Some changes are switched off here — says what and why.
The Move window for a story: choose the epic, the sprint and the position.
The Move window: every move also works with the keyboard.

Add and change

  • + Story at the bottom of a cell creates a story there, already in that cell's epic, sprint or release. In the small form you can pick the issue type; your choice is remembered.
  • + Epic (top right) creates a new epic column.
  • Click the coloured dot on an epic to change its colour.
  • Click a card (or press Enter on it) to open the issue in a new tab.
  • If a project needs more fields to create an issue than a summary, the map says so and creates nothing. Use Jira's own Create button there.
Adding a story in place under an epic, with the colour list of another epic open.
Add a story in place; pick an epic colour.

Filter

Type words or an issue key in Filter, or pick an Assignee or Label. The top line shows “x of y stories”. Clear filters shows everything again. Your rows, board, Show done, assignee and label filters and issue type are remembered for you, per project (the text filter is not).

Who can do what

Everyone who can see the project can see the map. What you can change follows your Jira permissions:

  • Edit issuesMove cards to another epic or release, change epic colours.
  • Schedule issues (as well)Reorder cards and epics, and move cards between sprints.
  • Create issuesAdd stories and epics.
  • No “Edit issues”The map says View only.

Questions and answers

I can't find the Slicewise tab.

It is in the project's top row of tabs; look under More. It only appears in software projects, and the app must be installed on the site.

A note says Jira refused a change because a field “is not on this project's edit screen”.

On most sites Jira accepts the map's changes whatever the edit screen holds, so nothing is switched off in advance. Where Jira does refuse, the change is put back, the reason is shown, and only that kind of change is switched off. A Jira admin can add the field (Sprint, Fix versions, Parent or the epic colour) to the project's edit screen; then click Refresh.

“Sprints” is greyed out in Rows.

None of the project's boards has sprints (Kanban boards, or team-managed projects with sprints turned off), or Jira did not answer for the project's boards.

I see two sprints with the same name.

Jira sometimes creates an empty starter sprint when a Scrum project is made. The map shows sprints exactly as Jira has them.

Some cells have no “+ Story”.

A story could not be put there for you (the project's create screen lacks the field, and you may not change it afterwards). The box at the top says where to add instead.

Why are there no story points on cards?

Points show when the project uses a story points field and the story has a value.

Can I remove an epic's colour?

No — Jira does not allow clearing an epic colour once set. You can pick another colour.

“Jira is busy right now (too many requests)”.

The site asked apps to slow down. The map already waited and retried a few times. Try again in a minute.

Do changes from colleagues appear live?

Not in version 1 — click Refresh.

Does the app send our data anywhere?

No. It is built on Atlassian's Forge platform, has no servers of its own and talks only to your Jira. See the privacy policy.

Still stuck? See Support or write to support@getslicewise.com.