How do I create a custom matrix?
How to build a selectable x and y axis grid and use it in a custom field
Contents
- 1. Introduction & Context
- 2. Key Features & Functions
- 3. Requirements
- 4. Step-by-Step Guide
- 5. Common Issues & Troubleshooting
- 6. Related Articles
1. Introduction & Context
A custom matrix provides the ability to display a grid to select from, with an x and y axis.
Creating a custom matrix takes two steps:
- Create the baseline matrix.
- Create the custom field with the type Custom Matrix and select the matrix you created.
2. Key Features & Functions
- Selectable grid: users pick a cell from an x and y axis grid.
- Highly configurable: you control the size, labels, font, colours, and what shows in the header, cells, and selected "pill".
- Fixed size after creation: the number of columns and rows cannot be changed once the matrix has been created (maximum 10 each).
- Used in a custom field: a custom matrix only appears once assigned to a custom field of the type Custom Matrix.
3. Requirements
- Access to the Admin section, specifically Custom Matrices and Custom Fields.
4. Step-by-Step Guide
Create the baseline matrix
- Navigate to the Admin section and open Custom Matrices.
- To create a new matrix, click Add and fill out the form. To edit an existing matrix, click the matrix and select Edit; the same form appears.
The matrix form has the following fields:
| Field | Description |
| Title | Can hold up to 154 characters. |
| Description | A longer free-text description. |
| Custom Image | Select an image to use as a hint icon, chosen from the images added under Images. |
| Number of columns | The number of columns your matrix will have. This cannot be changed once the matrix has been created (maximum 10). |
| Number of rows | The number of rows your matrix will have. This cannot be changed once the matrix has been created (maximum 10). |
| X-axis label | Name of the X axis. |
| Y-axis label | Name of the Y axis. |
| Font size | Size of the font used for each row and column header. |
| Enabled | Enable the matrix to be used in a custom field. |
| Column and row options | |
| Show description in header | Show the description of each row and column title in the header. |
| Cell options | |
| Show title in cell | Show the title of each cell in the matrix. |
| Show value in cell | Show the value of each cell in the matrix. |
| Show description in cell | Show the description of each cell in the matrix. |
| Resize cells to fit in pill | Show the title, value, and description of each element fully. This may distort the matrix. |
| Pill options | |
| Show row in pill | Show the row title of the selected cell in the pill. |
| Show column in pill | Show the column title of the selected cell in the pill. |
| Show cell title in pill | Show the cell title of the selected cell in the pill. |
| Show cell value in pill | Show the cell value of the selected element in the pill. |
| Reverse pill axes | Change the order of the two pills for column and row. |
Edit the cells
- Click into the cell you want to rename or add a description to.
- Click Mass edit cells and select the cells you want to edit. Then click Edit selected cells. Remember to select Apply to all for any fields you updated.
Each cell has the following fields:
| Field | Description |
| Title | Title of the cell. |
| Value | Numerical value of the cell. |
| Description | Description of the cell. |
| Colour | Fill colour of the elements. Choose from the options, or with a HEX colour code. |
Create the custom field
- To use your created custom matrix, navigate to Custom Fields and create a new custom field for your matrix.
- Select the type Custom Matrix, and select the matrix you created.
5. Common Issues & Troubleshooting
| Issue | Likely Cause | Solution |
| You cannot change the number of columns or rows | Size is fixed once the matrix is created. | Plan the dimensions before creating the matrix (maximum 10 columns and 10 rows). Create a new matrix if you need a different size. |
| You cannot edit a custom matrix | It has already been assigned to a custom field and used. | A matrix cannot be edited once assigned to a custom field and used. Set it up fully before using it. |
| The matrix looks distorted | Resize cells to fit in pill is on. | Turn off Resize cells to fit in pill, or accept that it may distort the matrix in exchange for showing all content. |
Click a title to preview it here. Use the Open full article button to read the full version in a new tab.
▾Custom Fields Open full article »
Related article
How to create a custom field, which is where you assign a custom matrix.
▾Risk Matrices Open full article »
Related article
Risk matrices, which are different from a custom matrix.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article