Admins and Project Admins can export settings from an existing project and import them to set up a new one, making it faster and easier to add new projects.
In this guide, we’ll show you how to:
- Export project settings
- Import project settings
Export project settings
Before exporting a project’s settings, note that only the following can be exported:
| Setting | Contents |
| General | Text formatting rules, parent-child issues, wiki, documents, Git, etc. |
| Issue type | Name, color, and issue template (e.g., task, bug) |
| Issue status | Status including custom status (e.g., open, in progress) |
| Category | Categories to use in the project |
| Milestone | Project milestones (start and end dates not included) |
To export settings from an existing project:
- Open the project whose settings you want to re-use.
- Select “Project Settings” in the side menu.
- Select General.
- Select "Export project settings.”
- The project settings will be downloaded as a JSON file (Backlog-ProjectTemplate-[Project Key].json).
Import project settings
To add a new project with imported settings:
- Select “Add Project” from the project settings in the dashboard or space settings.
- Select “Import from a configuration file.”
- Select the exported JSON file (Backlog-ProjectTemplate-[Project Key].json).
- Enter the project name and project key.
- Select “Add.”
A new project will be added with the imported settings.
Please note that:
- Importing and exporting is accessible by admins and project admins only.
- Importing custom attributes is only available to Premium plan users.
- Importing settings with duplicate issue types will cause an error. Review and rename all duplicate issue types before importing.