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

## Create an issue links matrix

1. On your Jira Cloud instance, navigate to 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. From the list, choose the **Issue Links Matrix** type.
5. On the **Add Matrix** page, you can set configuration options to build the matrix panel you want to see in your issue.
6. **Context > Linked Projects**: Choose the projects where you want the matrix panel to appear. By default, the Issue Matrix configuration is linked to the current project only. If you add more than one project in the **Projects to link** field, you will create a **multi-project configuration**. The Issue Matrix configuration and panel will appear in all linked projects.  
:info: With multi-project issue matrices, changes to the Issue Matrix configuration in one of the projects will affect the rest of the projects.
7. **Context > Issue Types: **After specifying the linked projects, choose issue types for each of them in the **Context > Issue Types** section.  
:info: Keep in mind, that the different projects might be associated with different issue types. For that reason, for each project, you need to choose the issue types where you would like to show the Issue Matrix panel.
8. **Type**: In the **Issue Link** **Types** section, choose issue links, which will be shown on your Issue Matrix.  
You can also specify a **Filter JQL** query to additionally filter the data displayed in the matrix.
9. **Data > Columns**: Configure the width and headers of the columns that the Issue Matrix will display. The columns correspond to custom fields from your Jira Cloud instance. The panel will visualize the values of the custom fields for each issue.
10. **Data > Results:** Select the maximum number of issues to be displayed in the Issue Matrix panel and set the number of results per page.
11. **Data > Categories** *(optional)*: Use JQL to set color categories for organizing your issues. Colored squares will appear on the left of issues that belong to a specific category. Note that each issue can only have one category.
12. **Sort by**: Set a default order for the data displayed in the matrix by choosing one or more fields in the **Sort By** section.
13. **Actions**: Set up actions to allow users to easily create and link new issues using predefined *Project*, *Issue Type*, and *Link Type* configurations. You can learn more in the [Create and Link Actions](https://appfire.atlassian.net/wiki/spaces/IMC/pages/259130002) document.
14. **Save** the configuration.

The new Issue Links Matrix will appear at the bottom of the list on the **Issue Matrices** page.

> ℹ️ Issue Matrix allows you to have completely different information in the issue views for the different projects. You just need to create different Issue Matrices in different projects.

## Inactive issue links matrices

Issue Links matrices become inactive if a Jira admin [deactivates issue linking](https://support.atlassian.com/jira-cloud-administration/docs/configure-issue-linking/) on the Jira site. This means you will not be able to see Issue Links matrices in your projects even though you will still be able to create, edit and view them on the Issue Matrices page

To identify inactive Issue Links matrices, check the **Issue Matrices** page. In the list, you will see an [issue links DISABLED] label under the Issue Links type matrices.