Skip to main content

Linear

Let Testiny serve as your Linear test management tool and connect test cases and results to Linear Issues. Testiny fully integrates into Linear — you can create, link and look up Linear issues from Testiny. Testiny makes complex issue-type configuration (with all its custom fields etc.) unnecessary. Testiny reads your issue configurations and performs the whole configuration in the background. Just link Testiny with your Linear organization — and you’re done!

Configuration​

To configure a new integration, you need to have admin rights in Testiny. Go to Settings > Integrations and click on 'Add button Add integration' for Linear. A side panel opens where you need to define the following options for the connection:

  • Linear API Key Create an API key for your Linear workspace and copy it into this field.
info

We recommend creating a non-admin user in Linear and assigning permissions to access only the teams/projects needed for the integration.

When the above fields are filled in, click the button "Test connection" to check if the credentials are valid and a connection to Linear can be established. When you’ve successfully connected Testiny with Linear, you can now configure the mapping of the projects, click "Continue" or directly go to the "Projects" tab. Here, you can define the scope of the integration for:

  • Testiny Projects

    • All projects
      By default, the integration is configured for all existing and future projects of your Testiny organization.
    • Only specific projects
      If you want to configure an integration for specific Testiny projects only, select this option. Now you can select for which projects you want to enable this integration.
    • For defects, for requirements or for both
      You can also define if you want to use this integration for defects only, for requirements only, or for both.

  • Linear Projects

    • All projects
      By default, the integration is configured for all projects.
    • Only specific projects
      If you want to configure an integration for specific projects only, select this option. Now you can select which projects you want to enable this integration for.

Using the Linear Integration​

The integration with Linear allows users to create and link issues in Linear from Testiny. Issues can be created or linked to test cases, test runs and test results and can be viewed in Testiny.

Creating or linking Linear Issues​

Within Testiny, you can link test runs and executions to Linear issues. If you find a bug during your tests, you can create an issue in Linear directly from Testiny. It is also possible to link requirements in Linear to test cases or create requirements in Linear directly from Testiny to build up your test coverage matrix.

Linear issues can be created (or linked to) in Testiny from the following entities:

  • Test cases
    It is possible to link requirements to test cases (a requirement can be any type of Linear issue) or to create a requirement that is automatically linked to the test case.

  • Test runs and test executions
    Testiny provides the ability to create defects (or link an existing issue) directly from a test run or a test execution.

When creating a requirement or a defect from Testiny, a create dialog will open where you can set the fields for the Linear issue. In this dialog you can select the Linear project, the issue type and set any other fields that may be required. Click "Create" to confirm. If pop-ups are allowed, the newly created issue will open in a new browser tab. Otherwise, a small window with the details and a link to the issue will appear.

When linking a requirement or a defect, a search dialog will open where you can search all existing issues directly in Testiny (no need to switch to Linear) and select the issue you want to link.

Accessing Linear Issues in Testiny​

Connecting Linear with Testiny allows you to directly look up and access Linear issues.
Testiny shows essential information such as the issue status inline. For further details on linked issues, the issue can be opened directly from Testiny by clicking the issue ID. Testiny supports issue links in various places:

  • Test cases
  • Test runs
  • Test results

If you have any further questions, need to get assistance, or want to leave feedback, either create a topic in our forum, use Testiny’s built-in feedback system or simply write us an email to: [email protected].