Skip to main content

Creating Linear Issues

QA Sphere seamlessly integrates with Linear, allowing you to create Linear issues directly while going through test cases in a test run. This integration streamlines your workflow and ensures efficient issue tracking within your Linear projects.

Configuring Linear Issues Integration​

To integrate Linear Issues into QA Sphere, follow these steps:

  1. Go to Settings by clicking the gear icon Settings wheel in the top right corner and choose Workspace Settings.
  2. Select Issue Trackers from the left sidebar.
  3. A list of all available projects will be displayed. Click the + button next to the appropriate project to add integration.
Adding Linear Issue integration
  1. Choose Linear from the list of available integrations.
  2. Next, authorize Linear integration with your account credentials.
Adding Linear Issue integration
  1. Choose a linear team for new issues to be created in.

Using Linear Issues Integration​

Once configured, the Linear Integration allows you to link existing issues or create new ones directly from QA Sphere while adding test case results. To create or link a Linear issue during testing:

  1. Within your project, navigate to the Test Runs section.
  2. Select an existing test run or create a new one.
  3. Choose a test case within the run.
  4. When changing the status of the test case, click + Attach Linear Issues and select one of the following options:

  • Link existing issue - Add a link to an existing Linear issue.

    Adding Linear Issue integration

  • Create new - Enter details by either manually entering the Title and Description or using AI to auto-generate the information based on test case details and result comments. A new Linear issue will be created in the assigned Linear project.

    Adding Linear Issue integration

All issues linked or created for the test case will be saved under the Action History for this test run, providing a clear trail of documentation.

Linear Issue History
note
  • AI issue generation may fail if there is insufficient context from the test case details and result comments to accurately determine the issue observed during testing.
  • AI issue generation is not available when batch-adding results for multiple test cases simultaneously.

Bidirectional Linking​

When you attach a Linear issue to a QA Sphere test case, a direct link back to the test case will automatically be added to the Linear issue description. This creates a seamless bidirectional connection between your test cases and issues, allowing team members to easily navigate between QA Sphere and Linear to access relevant context and information.

Benefits of Linear Integration​

  • Seamless Workflow: Create issues in Linear without leaving QA Sphere.
  • Consistency: Ensure all issues are properly documented and tracked in your Linear project.
  • Traceability: Easily link test cases to specific Linear issues for better tracking.
  • Efficiency: Reduce time spent switching between QA Sphere and Linear.
  • Team Collaboration: Improve communication between QA and development teams by centralizing issue reporting.

By leveraging this integration, your team can maintain a more cohesive and efficient testing and issue management process across QA Sphere and Linear.