# Shortcut

## About the integration ![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-271e420b0f424aa24dfd80f8a87158a23c94e092%2Fshortcut-logo.png?alt=media)

The Shortcut integration allows Sleuth to use Shortcut as a deployment issue tracker. When you deploy, Sleuth will automatically connect your Shortcut **stories** to the deploys, so you can always find the source of your changes later.

Integration with Shortcut is made at the Sleuth organization level. More than one [issue tracker](https://help.sleuth.io/integrations-1/issue-trackers) can be integrated with an organization. Although you can have multiple projects within an organization, each project can only configured to use a single issue tracker.

{% hint style="info" %}
Shortcut uses the term \*\*story \*\*as its standard unit of work. For Sleuth Documentation purposes and throughout the Sleuth application interface, the term **issue** is used instead, and is synonymous with **story**. Shortcut, similar to Jira, is an *issue* tracker.
{% endhint %}

## Setting up the integration

To set up the Sleuth Shortcut integration:

1. Click **Integrations** in the left sidebar, then click **Issue Trackers**.
2. In the Shortcut tile, click **enable**.
3. Enter the *API Token* of your Shortcut instance into the corresponding field, then press **Save**. To quickly access your Shortcut instance to obtain an API token, click **generate**.\
   ![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-aa73fed5748c089ea81e781de11f5cd007b6fb3f%2FScreenshot%202021-10-27%20at%2008.37.10.png?alt=media)
4. When integration is successful, Shortcut\*\* enabled\*\* is displayed in the tile.\
   ![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-b7cd2795a41d5bc4242d777083a640ba12be759b%2FScreenshot%202021-10-27%20at%2008.37.32.png?alt=media)

## Configuring the integration

After setting up the Shortcut integration, you must designate which Sleuth project to use as the default issue tracker. If you are configuring the integration immediately after setting it up, you can go directly to step #2 below.

### To set the default issue tracker:

1. Click on **Integrations** in the left sidebar, then on **Issue Trackers**.
2. Click on the Shortcut **Set default issue tracker** dropdown (see screenshot above).
3. All projects in the organization are displayed. Select which project you'd like to set Shortcut as the default issue tracker for.

You can also change the default issue tracker at any time.

### To change the default issue tracker:

1. Click on **Project Settings** in the left sidebar, then select **Details**.
2. Select a new default issue tracker. The integration **must be connected** at the organization level before it can be selected.\
   ![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-b08c0c02141fc6bfa517c2f239c198b421db6ab4%2FScreenshot%202021-10-27%20at%2008.38.11.png?alt=media)
3. Press **Save**.

### To set a new default issue tracker:

1. Click on **Project Settings** in the left sidebar, then select **Details**.
2. Select a new default issue tracker. The integration must be connected via the organization before it's displayed here.
3. Press **Save**.

## Removing the integration

#### If you wish to dissolve the Jira integration for the organization:

1. Click on **Integrations** in the left sidebar, then on **Issue Trackers**.
2. In the Shortcut integration card, click **disable**. The message Shortcut\*\* disabled\*\* is displayed in the Shortcut integration card once the integration is dissolved.

The Shortcut integration is disconnected and no longer available to any projects within that organization. You will need to select a new default issue tracker for any projects that used the Shortcut integration. Simply follow the instructions in the section above: **To set a new default issue tracker**.