---
title: "Issue Matrix configuration"
canonical: "https://support.appfire.com/space/IMC/227312949/Issue%20Matrix%20configuration"
format: markdown
---
> Macro (aura-html)

## How to configure Issue Matrix for Jira Cloud

**Configuring an Issue Matrix **is a quick and intuitive task. Each project or team has unique needs in their day-to-day tasks. Issue matrices help you meet these needs by displaying different information in the issue views of each project. To achieve this, simply create matrices of your choice in any project and configure their context, data, and visualization options.

Additionally, you can link one matrix **to multiple projects**. The matrix configuration and panel will appear in all linked projects with this option. Changes to the configuration in one of the linked projects will affect the rest.[ Learn more about project linking](https://appfire.atlassian.net/wiki/spaces/IMC/pages/228524436)

### Create Issue Matrices of different types

You can create matrices of five different types:

- [Sub-task Matrix](https://appfire.atlassian.net/wiki/spaces/IMC/pages/228491862) - shows the sub-tasks of the current issue.
- [Issue Links Matrix](https://appfire.atlassian.net/wiki/spaces/IMC/pages/228589839) - shows issues linked to the current issue.
- [Epic Matrix](https://appfire.atlassian.net/wiki/spaces/IMC/pages/228459128) - shows the issues linked to the current epic issue.
- [JQL Matrix](https://appfire.atlassian.net/wiki/spaces/IMC/pages/227903219) - shows issues returned by a custom JQL query.
- [Similar Matrix](https://appfire.atlassian.net/wiki/spaces/IMC/pages/324569555) - shows issues similar to the current issue

In the matrix configuration, you can specify issues of which types will be displayed in the matrix panel, for example, *stories*, *sub-tasks*, *bugs*, etc. 

For multi-project matrices, you can **specify issue types per project**. Respectively, a given project’s matrix panel will display only the issues selected from that project.

After completing the configuration, Issue Matrix immediately transforms your issue views and makes the necessary information visible to all stakeholders in a team or project. Based on the additional information that is easily accessible within a single issue view, your team’s processes and decisions are much more effective.

For a quick tour of Issue Matrix’s features, see the [Get started with Issue Matrix](https://appfire.atlassian.net/wiki/spaces/IMC/pages/227411290) article.

![image](media://efda7383-a55e-4173-8313-f5b6b23337a8)

## Create and configure Issue Matrices

**To create and configure Issue Matrices:**

1. On your Jira Cloud site, navigate your **Project settings **or **Project settings > Apps **for *team-managed projects*.
2. On the left menu, choose **Issue Matrix configuration**.
3. On the **Issue Matrices **page, click the **Add Matrix** button.
4. Choose the type of the Issue Matrix from the list: *Sub-tasks, Issue Links, Epic, JQL, *or* Similar.*
5. **Context**: On the **Add Matrix** page, configure the **context** of the Issue Matrix: choose the projects and the issue types for each project where the Issue Matrix panel will be shown.   
[Learn more about project linking](https://appfire.atlassian.net/wiki/spaces/IMC/pages/228524436)
6. **Type**: In the **Type** section, choose the issue types shown in your Issue Matrix.
7. **Data > Columns**: Configure the columns (custom fields, columns width, columns headers, and aggregations) the Issue Matrix will show.
8. **Data > Results: **(*not applicable to the Similar Matrix type*) Select the maximum number of issues to be displayed in the Issue Matrix panel and set the number of results per page.
9. **Data** > **Categories: ***(Optional) *Configure issue categories to organize and highlight specific issues more easily using colors.
10. **Sort By**: For the *Sub-task*, *Issue Links*, and *Epic* Issue matrices, you can set a default sort order for the issues displayed in the Issue Matrix panel. You can choose one or more columns as a default sorting criteria among the sortable custom field list.  
:info: For JQL matrices, sorting can be achieved using sort clauses in the JQL query.
11. **Preview**: Enter an issue key in the *Preview* area to see how the matrix panel will appear in this issue.
12. **Save** the configuration.

![image](media://2469a4eb-76e3-4f26-9c2f-377768c58275)