> ## Documentation Index
> Fetch the complete documentation index at: https://docs.retasc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear, Jira, ClickUp, Asana or Shortcut migration

> Linear, Jira, ClickUp, Asana, or Shortcut, in one pull: issues, comments, labels, relations, and attachment files, authors included.

Five sources, one flow: paste a token, pick the project, say what your columns mean,
import. An owner or admin runs it from **Connectors → Migrate**; one import runs per
org at a time.

Linear

Jira

ClickUp

Asana

Shortcut

| Source | You pick a… | Identifiers | Token from |
| - | - | - | - |
| **Linear** | team | kept as `TEAM-N` | Settings → Security & access → Personal API keys |
| **Jira** (Cloud only) | project | kept as `PROJ-42` | id.atlassian.com → Security → API tokens |
| **ClickUp** | list | renumbered `PREFIX-N` | Settings → Apps → API Token |
| **Asana** | project | renumbered `PREFIX-N` | Settings → Apps → Developer → Personal access tokens |
| **Shortcut** | team | story numbers kept | Settings → API Tokens |

## Set up

**1. Pick the source**

**Connectors → Migrate**, then the source's card.

**2. Paste the token**

Used live for this run only, never stored. Jira also asks for the site
(`your-domain.atlassian.net`) and account email.

**3. Fetch targets, pick one**

The team, project, or list to bring across.

**4. Say what your columns mean**

Jira, ClickUp, and Asana surface each source column to map to `todo` / `doing` /
`review` / `done` / `canceled`, pre-filled from the column's *type*, never its
name. A column mapped to `review` needs a named reviewer. Linear and Shortcut type
their own columns, so they skip this step.

**5. Import**

Live progress, then a summary: created, updated, comments, links, files.

**6. Claim your history**

Imported authors arrive as placeholder members. Each real person clicks "That's
me" once, and their authorship *and* their assigned backlog move onto their live
account.

![The Dash's import mapping: each source column pointed at a Retasc status](https://mintcdn.com/retasc/j7UjBeNpjLsHiVcO/images/ui/import-columns-light.png?fit=max\&auto=format\&n=j7UjBeNpjLsHiVcO\&q=85\&s=6d72ab357176f314d989cd66ce94ff05)

![The Dash's import mapping: each source column pointed at a Retasc status](https://mintcdn.com/retasc/j7UjBeNpjLsHiVcO/images/ui/import-columns-light-phone.png?fit=max\&auto=format\&n=j7UjBeNpjLsHiVcO\&q=85\&s=dc71bf8fe0339286c0d809d9fdcfda68)

![The Dash's import mapping: each source column pointed at a Retasc status](https://mintcdn.com/retasc/j7UjBeNpjLsHiVcO/images/ui/import-columns-dark.png?fit=max\&auto=format\&n=j7UjBeNpjLsHiVcO\&q=85\&s=70867872bf7250aa9f1764e2c6284e45)

![The Dash's import mapping: each source column pointed at a Retasc status](https://mintcdn.com/retasc/j7UjBeNpjLsHiVcO/images/ui/import-columns-dark-phone.png?fit=max\&auto=format\&n=j7UjBeNpjLsHiVcO\&q=85\&s=551d1c944aba0ce63dc7180d66c0a38e)

> [!WARNING]
>
> **Re-importing overwrites your Retasc edits.** A second run never duplicates; it
> re-syncs, so status, labels, title and body snap back to whatever the source says
> now. Two weeks of moving issues along in Retasc can vanish. You are warned, with the
> date of the last import, before it runs.

> [!NOTE]
>
> **Same flow in the terminal:** `retasc import` walks the identical steps (source,
> token typed with echo off and never a flag, target, column mapping, import) and ends
> on the same identity-claim prompt.

## Next steps

> [card] [Onboarding: starting fresh](https://docs.retasc.com/onboarding-owner.md)
>
> Where an import fits in a new org's first hour.

> [card] [Notifications](https://docs.retasc.com/notifications.md)
>
> Connect a DM channel once your history is in.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.