Customising Cards

Don't rely on people clicking cards to view the issue details. Customising the cards for your boards can help you bring the right information to your team's attention, at a glance.

In JIRA Agile, you can change the card colours to help people quickly identify cards on your board as being of a particular issue type, priority, assignee, or — thanks to the power of JQL — practically anything you choose. You can also add up to three additional fields to display on cards in the Backlog and the Active sprints/Kanban board.

Note, you must be the administrator of a board (or a person with the 'JIRA Administrators' global permission) to customise a card.

On this page:

Configuring card colours

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

To configure card colours:

  1. Navigate to the desired board, then click Board > Configure.
  2. Click Card Colors and change the Colors based on dropdown as desired. If you change to a different method of card colouring, your settings for the old method will be retained so you can switch back to them later if you wish. 

      Read more about the card colouring methods
    Base your card colours on... Explanation
    Issue Types

    One colour per issue type. A default colour will be allocated to every issue type which matches issues on the board. Note, the issue type must already exist in your project to configure the colour for it. Also, the colour 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 colours for the issue types. 

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

    Priorities One colour per priority. The default colours are the same as used for priorities in JIRA.
    Assignees One colour per assignee. A default colour 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.
    Queries

    One colour per JQL query. You can specify whatever queries you wish. Issues which do not match any of your JQL queries will be shown in grey. For information about JQL syntax, see the JIRA JQL documentation. 

    Example queries:

    • Show all issues which belong to a particular component (e.g. 'User Interface'):

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

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

      reporter = "Jane"

      and

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

    • Pick a different colour for a card — Click the  Color  square, e.g.
    • Delete a card colour — Click  Delete . This effectively resets the card to the default colour, if you still have issues matching that card type (refresh the screen — the deleted card colour will show, reset to the default colour).
    • Move a card colour (Query-based only) —  Hover over the vertical 'grid'   icon, then drag and drop the colour up or down to its new position.

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

Screenshot: Configuring card colours for a board

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 versus the Active sprints, if you are using a Scrum board.

To add fields to :

  1. Navigate to the desired board, then click Board > Configure.
  2. Click Card layout, then add or delete fields as desired.

Screenshot: Cards displaying additional fields in the Backlog

Screenshot: Cards displaying additional fields in the Active sprints

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport