Shortcut

Modern unified Shortcut test management with Testmo. Link your testing efforts to Shortcut stories and integrate manual test cases, exploratory testing and test automation.

Learn more about Testmo ➞

Testmo integrates with Shortcut so you can add new issues (stories in Shortcut) from Testmo, link Shortcut issues from various entities such as test results and cases, and directly report & access referenced issues.

The Shortcut integration uses Testmo's link-based integration that enables you to work and integrate with various issue trackers. This page explains how to configure and use the Shortcut integration in Testmo.

Configuring the Shortcut integration

To configure the Shortcut integration, in Testmo go to Admin > Integrations. You need to be a project or site administrator in Testmo to access this area. Then follow these instructions:

  • Select Custom issue tracker

  • Click + Issue tracker

  • In the Add issue tracker dialog, enter the details of your Shortcut instance:

    • Name: Select the name you want to use for the integration. The name will be displayed in Testmo when choosing an issue tracker integration.

    • New issue link: This is the link users are redirected to when adding new issues from Testmo:

    # Replace <name> with your Shortcut workspace name
    https://app.shortcut.com/<name>/stories/new
    • View issue link: When users click on a linked Shortcut issue ID, users are redirected to this address. Testmo replaces the $(id) placeholder with the actual ID:

    # Replace <name> with your Shortcut workspace name
    https://app.shortcut.com/<name>/story/$(id)
    • Issue ID format: For Shortcut, select Number

Using the Shortcut integration

The integration allows users to add new issues to Shortcut during testing and during test case design. Users can also access linked Shortcut issues from tests, cases, runs etc. from the entity pages and issue reports to implement Shortcut test management with Testmo.

Adding new Shortcut issues

To create new Shortcut issues from Testmo, simply follow these steps:

  • From any entity supporting issues in Testmo (such as cases, test results, runs, milestones etc.), click the Add link next to the Issues field (you can find this field in the entity's Add/Edit dialog or from inline result forms)

  • In the Add issues popup:

    • Select the configured Shortcut issue tracker (see above)

    • Either enter one or more existing Shortcut issue IDs in the Issue IDs field, or click the + New issues link to access Shortcut

    • When adding new issues, create the issue in Shortcut, then close the window and enter the new Shortcut issue ID

    • Confirm the new issue links by clicking Add

Accessing Shortcut issues from Testmo

After referencing Shortcut issues by linking existing or new issue IDs (see above), you can directly navigate to the issue in Shortcut to review the details or update the status. Testmo supports issue links in various places:

  • Milestones

  • Cases

  • Runs

  • Test results

  • Sessions

  • Session results

  • Automation comments

Linked issues are also listed on the Issue report pages for milestones, runs and automation.

Last updated