Bringing the work your team has completed with you has never been easier. Your progress, history, insights, and all the wins you’ve made together in Trello can now be imported directly into Shortcut.
We’ll work to improve every facet of this import process using your direct feedback and insights along the way. Ready to get started?
Team Preparation
We’re excited to start this process with you! Let’s start by making sure you’ve considered the following:
-
Ensuring you have proper Administrative permissions in Trello and Shortcut
-
Speaking with the various teams on your side associated with the data you’re importing to ensure that you have a working knowledge of their needs
Tip: We’ve heard collecting your import information in a spreadsheet can streamline this process.
Requesting Import Permissions
Within Shortcut, we start by asking your team to set up permissioning that allows us to talk freely to Trello. Here’s what you’ll need to start the process:
-
Your unique Trello Auth Key
-
A unique Auth Token (can be revoked immediately after import process completes)
Your Auth Key helps our importer connect to the right Trello instance, and your Auth Token lets Trello know that we have permission to read and transfer your files.
To generate both of these, follow the steps below:
- Login and navigate to "Power Up" https://trello.com/power-ups/admin
- Generate a new Auth Key and Token by selecting "New" on the dashboard main page, and follow the steps to generate a new Auth Key
- Follow the embedded link to generate the Auth Token:
For more detailed information, please visit Atlassian's documentation: https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/
Mapping
Let’s dig into the heart of the import process - telling your Trello data where it will now live in Shortcut. We recommend working through this part as a team when possible to ensure that everyone is comfortable with where their data will be mapped.
Here's what you'll need to have handy:
- Trello Board ID(s): These are found within the URL of the board or boards you’re looking to import. Look for a number just like this from a logged-in view of Trello:
-
Board Name(s): This helps us organize the data during the process and helps to keep the import readable.
-
Target Shortcut Workspace name: Which Workspace will this data be added into?
-
Target Shortcut Workflow(s) for each Board: All cards from a Trello Board will be mapped directly into an existing Shortcut Workflow.
-
User Mapping: Which Trello Users should be mapped to existing Shortcut Users? Which users can’t be mapped, and need an invite to Shortcut?
-
Default Story Requestor: If we cannot find a Trello Card creator, which Shortcut User should be the fallback Story Requestor? (usually, this is the user running the import)
What else will be imported from Trello?
In addition to the core functionality, we’re also excited to announce that the following data will also be imported:
-
Card Descriptions
-
Designations (Owners, Requesters/Creators, and Followers)
-
Labels
-
Comments
-
Attachments
-
Due Dates
-
Custom Fields (imported as Shortcut Labels)
-
Checklists (imported as Shortcut Tasks on a Story)
Mapping Logic
| From Trello: | Into Shortcut: |
|---|---|
|
Boards |
A single Trello Board will be imported into an existing Shortcut Workflow. |
|
Cards |
Will map to Shortcut Stories. All non-archived Cards from a single Board will be imported. All Stories will be created as a “Feature” Story Type w/in Shortcut. |
|
Users |
Will import all Users that have access to the given Trello Board. These can be mapped to existing Shortcut users, invited after the imported as new users, or not invited at all (will map to the default Story requester). All hierarchy ownership of Stories and Comments will persist within the imported data - if a User owns something in Trello, they will retain this permission in Shortcut. |
|
Lists |
All Imported Stories will be placed into the first unstarted Workflow State for the select Workflow w/in Shortcut. We will add a Shortcut Label to each Story with the associated Trello List Name (e.g. [board_name] - [list_name]). We suggest using these Labels to move Stories into the appropriate Shortcut Workflow State using bulk editing. |
|
Labels |
“Complete” Label is added to all Cards with Due Date marked Complete in Trello. “Stale” label is added to all Trello cards that haven’t been updated in the past 90 days (to make archiving easier). All imported Cards will be Labeled with the name of their previous Trello Board to make the cleanup process as easy as possible on your team. |
Bulk Editing Imported Data
We find that our teams are able to easily find homes for the various values you’ve brought in by using our bulk editing functionality.
To read a little more about how to edit and assign large groups of Stories, please check out our article here on Bulk Editing Multiple Stories.
Reverting Imports
Need to regroup after an import? Not to worry - we’ve made sure that Imports can be reverted. This will delete all Stories, Labels, and Users created during the import to give your team a clean slate and restore your Shortcut instance back to before the import process was started.
To request that your import be reverted, please create a new ticket here with the subject “Revert Trello Import” for the fastest support.
Need to Run a Second Import?
Running a second import will create new stories for Trello cards that have already imported, resulting in duplicates.
There are a few of options to get those additional cards into Shortcut as Stories:
- Create a new Trello board, move the new cards there, then import just that board (this is the easiest option, but note that these won’t be in the proper board in Trello, if that matters.)
- Rollback the prior import completely and re-import to get the new stories (Note that this will cause any changes done on the Stories that were part of the prior import to be lost)
- Do a new full import into a different board, then move the net new stories to the correct project, followed by a deletion of the remaining duplicates - very manual or would require scripting!
- Create new Stories manually in Shortcut for the new tickets in Trello.
Updated