Create and Link Actions

On this page:

Create and link issues with predefined configuration

With Issue Matrix Cloud, you can set up actions to allow users to easily create and link new issues using predefined Project, Issue Type, and Link Type configurations. You can configure the actions when creating an Issue Links matrix, and then access these actions from the Issue Matrix panel in the issue view screen.

To find the actions in the issue view screen, just look for the “more” menu in the upper right corner of the Matrix panel. You'll see them listed there, as shown in (1) and (2) on the screenshot below.

Create and Link Actions configuration

To configure Create and Link Actions:

1. Go to Project settings or Project settings > Apps for team-managed projects.

2. From the left menu, choose Issue Matrix configuration.

3. If you are creating a new matrix, click the Add Matrix button on the Issue Matrices page and select Issue Links as type from the dropdown. If you want to configure actions for an existing Links type matrix, click the pencil icon in its Actions column.

4. Navigate to Actions > Create and Link Actions in the configuration.

5. Configure the settings for creating and linking issues:

• Name - The link title in the “more” menu dropdown just above the Matrix panel.

• Project - The project of the newly created issue.

• Issue Type - The type of the new issue.

• Link Type - The link type between the currently viewed and the newly created issue.

How to create and link new issues?

The Create and Link actions feature in the Issue Matrix panel makes it easier to create new issues. It automatically fills in the Project, Issue Type, and Linked Issues fields on the Create issue screen with information from the Issue Matrix configuration.

To create and link new issues using the Issue Matrix panel:

1. Open an issue in a project that has an Issue Links Matrix set up.

2. Click the "more" menu in the top-right corner of the Issue Matrix panel.

3. Choose a preconfigured action from the dropdown menu.

4. The Create issue screen will appear with Project, Issue Type, and Linked Issues fields pre-filled with the values configured for the selected Issue Matrix’s action.

5. Enter a Summary for the new issue.

6. Modify the pre-filled values for the Project, Issue Type, and Issue Link Type fields if needed.
   ⚠️ Note that some projects may not display the Linked Issues field (which defines the link type) on the Create issue screen for the specified issue type. If this is the case, the new issue will still be created and linked to the current issue, but users will not be able to modify the preconfigured link type for the action.

7. Add any other necessary information, then click Create to finish. If you want to create and link additional issues, select the Create another checkbox before clicking Create.

8. The new issue will be added to the project and linked to the current issue. If Create another is selected, all issues will be added to the project and linked to the current issue after the user creates their last issue.

How to fix problems in projects with a missing Linked Issues field on the Create issue screen?

Problem: When creating and linking a new issue in a project that doesn't have the Linked Issues field (i.e. the field which defines the link type) present on its Create issue screen, the issue may be created but not linked. If the Create another checkbox is selected, the created issues may all fail to link to the current issue.

Symptoms:

• The Issue field doesn’t appear in the Create and Link screen when creating the new issue.

• The new issue is created and added to the project but is not linked to the current issue.

• The following warning message appears on the screen: “We encountered an error while trying to link issue 'X' to the current issue. Issue 'X' has been created but is not linked. Try linking the issue manually.” If the Create another checkbox is selected, the warning message will not be displayed for any of the issues that fail to link.

Possible causes:

• Your Internet connection might be unstable or slow.

• There might be a problem with the Jira Cloud site.

Solution:

1. Find the newly created issue in your project.

2. Open the issue that you want to link the new issue to.

3. Go to the “more” menu > Link Issue.

4. Manually add the issue key of the new issue and select the link type.

5. Click Link to link the issues.

If the issue still doesn't link properly, contact Atlassian’s support.