Import tasks and bugs from Jira, Trello, HacknPlan or a CSV file
For the producer or LEAD who moves a project into Gameheim. Pick the source, check the preview, confirm. Importing again updates instead of duplicating, and an import can be undone as long as nobody changed what it created.
Moving a board should not cost a week
A project that changes tool carries hundreds of tasks and bugs, with their comments, statuses and people. Copying them by hand takes days, and a one-shot script leaves duplicates the moment someone runs it twice.
How an import works
Gameheim reads the source, shows a preview where you map types, statuses, priorities and people, and writes nothing until you confirm.
| Source | What you need | What comes in |
|---|---|---|
| Jira Cloud | The site on atlassian.net, your Atlassian e-mail, an API token and the project key | Tasks, bugs, comments and attachments |
| Jira XML export | Up to 10 XML exports of Jira Cloud or Data Center | Tasks, bugs and comments |
| CSV file | One UTF-8 file with an id and a title column | Tasks and bugs, comments from the comment columns |
| Trello | Sign in with Trello and pick the board | Cards, lists as statuses, comments and checklists |
| HacknPlan | The studio's HacknPlan API key and the project | Work items, stages, categories, comments and subtasks |
How to run an import
- The permission to manage tasks on the project; to create bugs, also the permission to write bugs. Assigning tasks to other people needs the assign permission, otherwise tasks arrive unassigned and the report says so.
- Your organization's plan includes importing.
Open Imports
On the Task Board, click Import, then New import, and choose the source.
Analyze the source
Fill in what the source asks for and click Analyze. Nothing is written yet. A Jira token or a HacknPlan key is used for this import only and deleted when it ends. Revoke the HacknPlan key afterwards: there it does not expire.
Check the preview
Map each source type to Task, Bug or Skip, then statuses, priorities and people. People are matched by e-mail when the source gives one; whoever is not matched stays unassigned, with the name kept in the item.
Confirm
Click Import N items, with N the number of items to bring in. The page shows the progress, and you get a notification when it ends. A preview not confirmed expires after 7 days.
Attachments and limits
- Attachments are downloaded from Jira Cloud. The other sources list them in the report.
- Up to 20,000 tasks and bugs per import; files up to 50 MB each.
- One import at a time per organization.
- An import read with your token can be confirmed only by you.
Frequently asked questions
Will importing twice create duplicates?
No. Each item remembers its source, and the second import updates it, unless someone changed it in Gameheim since.
Can I take an import back?
Yes, with Undo import. It removes only the items nobody changed since; the others stay and are listed.
Does Gameheim keep my Jira token or HacknPlan key?
No. It is used for this import only and deleted when the import ends, and it is never shown again. In HacknPlan the key does not expire, so revoke it there once the import is done.
What happens to people who are not in Gameheim?
People are matched by e-mail when the source gives one, or by hand in the preview. Whoever is not matched stays unassigned, and their name is kept in the item so nobody loses track of who did the work.
