Issue Templates / Docs / Import, export and examples / Importing templates
Importing templates
Last updated 11/06/2026
Flow
- Open Import / Export, choose the JSON file.
- Decide whether Create templates that don't exist yet should be on (otherwise only existing templates are updated).
- Select Preview import. A review dialog shows exactly what will be created and updated, plus anything skipped or invalid (with reasons). Nothing is written yet.
- Rename any incoming template directly in the dialog, then confirm the import.
Matching
Templates match by id: known ids update in place, unknown ids are created (when enabled). Duplicate ids within one file: the first occurrence wins.
Same-site caveat
Field option ids and child work item type ids are site-specific, so imports are intended for the same site the file was exported from (backup/restore), or sites with identical configuration.