Before you begin

You must be a Jira administrator or a board administrator for the board to customize its cards.

Benefits of customizing cards

By customizing the layout of the cards on your board, you're bringing just the right level of information to your team's attention, at a glance.You can change the card colors to help your team quickly identify the cards on your board as being of a particular issue type, priority, assignee, or anything you choose — thanks to the power of JQL. You can also add up to three fields to display on the cards.

Screenshot: Sample cards in a Scrum backlog

  1. Issue summary
  2. Issue details
  3. Custom fields

Screenshot: Sample card in Active sprints of a Scrum board

Issue cards have three layers of information that are stacked on top of each other, and are always stacked in the same order:

  1. Issue summary.
  2. Custom fields added to the card.
  3. Other related issue information, including issue type, priority, assignee, and estimate.

In both the backlog and board across Scrum and Kanban, the issue summary is consistently at the top level of the card.

To view more issue details, do one of the following:

  • Click an issue card to see more details in the issue detail view.


    tip/resting Created with Sketch.

    We're rolling out a new issue view, with a consistent appearance across Jira and one screen to view and edit. It looks a little different and some procedures have changed slightly, so take a look at What is the new Jira issue view? to see what's changed.

  • To see the issue details in full view in a new tab or window, right-click on the issue key, and then view the issue in a new tab or window.

Configuring card colors

You can base your card colors on issue types, priorities, assignees, or JQL queries. Once you have chosen a method, you can change or delete the colors for each type of card. This can be configured per board (not globally).

  1. Click Projects > then select the relevant project.
  2. Go to your Scrum  backlog, Active sprintsKanban backlog (if enabled), or Kanban board.
  3. Click Card Colors and change the Colors based on drop-down as desired. If you change to a different method of card coloring, your settings for the old method will be retained so you can switch back to them later if you wish. 

    Base your card colors on...Explanation
    Issue types

    One color per issue type. A default color will be allocated to every issue type that matches issues on the board.  Note, the issue type must already exist in your project to configure the color for it. Also, the color values won't display until an issue is created on your board. You need to create an issue on your board first, to configure the colors for the issue types.

    Default issue types and colors: Improvement, Task , New Feature , Bug

    PrioritiesOne color per priority. The default colors are the same as used for priorities in Jira.
    AssigneesOne color per assignee. A default color will be allocated to every user who is or has been an assignee of issues on this board. Note, the color values won't display until an issue is created on your board. You need to create an issue on your board first, to configure the colors for the assignees.

    One color per JQL query. You can specify whatever queries you wish. Issues that do not match any of your JQL queries will be shown in grey. See JQL for more information about JQL syntax. 

    Example queries:

    • Show all issues that belong to a particular component, e.g. 'User Interface':

      project = "Angry Nerds" AND component = "User Interface"
    • Show all issues that are due in the next 24 hours:

      due <= "24h"
    • Show all issues created by a particular user, e.g.:

      reporter = "Jane"


      reporter = "Bob"
  4. Once you have picked a method to base your colors on, customize the colors as follows:

    • Pick a different color for a card — Click the Color square, e.g. .

    • Delete a card color— Click Delete. This effectively resets the card to the default color. If you still have issues matching that card type, refresh the screen to reset the deleted card color to the default color).
    • Move a card color (Query-based only) — Hover over the vertical 'grid'   icon, then drag and drop the color up or down to its new position.

      Note: For Query-based colors, the order is important, as each issue will be colored according to the first query that it matches (e.g. if your first row has query "issuetype = bug" and is colored red, and your second row has query "assignee = kevin" and is colored green, then bugs assigned to Dave will appear red).

Adding fields to cards

You can configure cards on a board to display up to three additional fields. The fields can be different for the Backlog and Active sprints, if you are using a Scrum board.

To add fields to cards:

  1. Click Projects > then select the relevant project.
  2. Go to your Scrum  backlog, Active sprintsKanban backlog (if enabled), or Kanban board.
  3. Go to ••• > Board settings and click Card layout.
  4. Add or delete fields as desired.
  5. Enable the Days in column toggle to display how many days an issue has been in the board columns.

Using Days in column

 This indicator is disabled by default for Scrum boards and enabled by default for Kanban boards.

When you enable days in column, the number of the days that an issue has been in a column are represented by a series of dots on the card itself. This helps you see issues that are stagnating — this is particularly useful when your board is displayed as a wallboard.

Dots in cardsNumber of days in column
1 day
2 days
3 days
5 days
8 days
12 days
20 or more days

Note that if you move an issue back to a column where it's previously been, the indicator gives you the cumulative number of days the issue has stayed in that column.

For example, you move an issue to the 'In Progress' column, and it stays there for 2 days. You then move the issue to the 'Code Review' column, and it stays there for 1 day. During code review, you receive feedback, which requires more development work for the issue. So, you move the issue back to the 'In Progress' column, and it stays there for 1 day. In this example, the indicator reflects the cumulative value of 3 days for the issue in the 'In Progress' column.

If you have a large instance (i.e. 300,000+ issues, 100+ projects, 100+ boards, or 100+ open sprints), we recommend that you disable this indicator to improve performance.

Printing issue cards

Whether you're planning work or working on issues for Scrum or Kanban projects, it may also be good to print out these issue cards. You and your team can use the printed cards on a physical board, which can be a replication of your board on Jira Software. You can print a single issue card or multiple issue cards, if you want. You can also print all issue cards in your current board.

The printed issue cards include the following issue details:

  • Summary
  • Issue type
  • Issue key
  • Issue priority
  • Estimate
  • Assignee
  • Epic (optional in Active sprints/Kanban board)
  • Version (when printing from the backlog)
  • Up to 3 extra fields, depending on your card layout configuration

The printed issue cards fit on A4-, A3-, or Letter-sized pages in both portrait and landscape modes.

Next steps

 Need help? If you can't find the answer you need in our documentation, we have other resources available to help you. See Getting help.

  • Read Printing issue cards to learn how to print issue cards and use a physical replication of your board in Jira Software.