Guidance Backup (Import and Export)¶
Purpose¶
Use the Guidance import/export flow to export or import guidance datasets, including associated media files.
This is useful for migrations, rollouts, and restoring instructions after changes.
Steps (export)¶
- Open App > Guidance.
- Enter the search view, then open the filter panel.
- Open Import / Export.
- Optional: enable Export full history to include all guidance versions.
- Download and store the backup file securely.
Steps (import)¶
- Open App > Guidance.
- Enter the search view, then open the filter panel.
- Open Import / Export.
- Select Import and choose the backup file.
- Optional: configure import options:
- Overwrite duplicates: update matching items instead of creating parallel copies
- Include history: import all versions instead of only the latest state
- Confirm the import.
What users see¶
- An import/export modal from the Guidance filter panel.
- Export and import actions.
- Options such as:
- Export full history
- Overwrite duplicates
- Include history
Best practices¶
- Export a backup before major guidance edits or system migrations.
- Store backups according to your data/security policy.
- Restrict restore permissions to trusted roles.
Troubleshooting¶
- Import fails -> Backup file is invalid or incomplete -> Retry with a known-good export -> Escalate with the error message and backup timestamp
- Imported guidance looks duplicated -> Import options did not overwrite matching items -> Re-import with Overwrite duplicates if appropriate -> Escalate to an admin if you need a clean reset