Gameheim

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.

By Gianmarco Virzì, co-founder and lead developer of Virsion · Updated · 3 min read

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.

SourceWhat you needWhat comes in
Jira CloudThe site on atlassian.net, your Atlassian e-mail, an API token and the project keyTasks, bugs, comments and attachments
Jira XML exportUp to 10 XML exports of Jira Cloud or Data CenterTasks, bugs and comments
CSV fileOne UTF-8 file with an id and a title columnTasks and bugs, comments from the comment columns
TrelloSign in with Trello and pick the boardCards, lists as statuses, comments and checklists
HacknPlanThe studio's HacknPlan API key and the projectWork items, stages, categories, comments and subtasks

How to run an import

Before you start
  • 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.
  1. Open Imports

    On the Task Board, click Import, then New import, and choose the source.

  2. 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.

  3. 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.

  4. 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.