Importing and Exporting
GitKraken Boards allows you to import and export boards in CSV format.
Importing a board
To import a CSV file as a board, navigate to the Home page, select CSV from the dropdown, and select Import.
Fill out the Board Name and select a CSV to import. Then, select .
You will then be prompted to invite imported users to the board via email. If a username is provided, you will be prompted to fill out their email. If the email does not have an associated GitKraken account, you will be prompted for a name that can be changed by the user later. If no email is provided, the user will not be invited to the board.
Note: Users who do not have a GitKraken account will be prompted to create one from the invite email. If you are on a Free account importing more than 15 users, you will be prompted to only select 15 users.
Finally, select . While the board is being imported, you can select Go Back to GitKraken Boards.
CSV File
- The CSV must contain a top row. The accepted fields are Name, Column, Description, Labels, Assignees, Due Date, and Milestone. This is case insensitive.
- Name is the only required field for the top row and for a card to be imported.
- Column is the column name. If a column name is not provided, the card will be placed into a newly created column called "Imported Cards".
- Labels are a comma separated string of label names. Labels will be created and colors will be randomly generated.
- Assignees are a comma separated string of either usernames or emails.
- Due Date can be any format that the javascript Date object accepts. Some common formats are MM/DD/YYY, YYYY-MM-DD or MMM DD YYYY.
- Milestones are the milestone name. Only one milestone is accepted per card.
Example CSV
Click here to download a small example CSV that can get you familiar with the format. You can also export an existing board to see the format.
Exporting a board
To download all active cards from a board into a CSV, navigate to Board Settings, select Export and then Export. You can set the name of the CSV and location. Then select Save
.
The fields exported are Name, Column, Description, Labels, Assignees, Due Date, and Milestone.