Migration (SG-Admin)
| Field | Value |
|---|---|
| Audience | public |
| Page type | reference |
| Area | sg-admin |
| Updated | 2026-05-14 |
The SG-Admin Migration surface — per-site entry for migration operations.
The Migration surface in the admin is the per-site entry point for migration operations — running imports, monitoring import progress, accessing backups, running search-and-replace passes, scoping rollback. The deeper structural framing lives in the Migration and Import Reference area; this surface is the per-site operational entry. This page is the Reference definition.
What is this for?
Read this page when you want the structural definition of the per-site migration entry surface.
Good use cases
- You are running a migration into the active site.
- You hit a "where do I start the import?" question.
What NOT to use this for
- The end-to-end migration framing — open Migration and Import Overview.
- Per-step procedures — open the relevant Guide.
- Per-release shipped change — open What's New or Changelog.
How this connects to other features
- SG-Admin Overview — parent surface.
- Migration and Import Overview — the broader Reference area.
- Import — the entry-path Reference.
- Backups — the safeguard Reference.
Where to find it
Open SG-Admin for the active site. Migration is in the sidebar under the configuration or tools group. The import action, backup index, search-and-replace entry, and validation queue are all reachable from the Migration surface. Admin access is required.
Definition
The SG-Admin Migration surface is the per-site operational entry for migration work. It surfaces the import action, the backup index for the active site, the search-and-replace utility entry, the post-migration validation queue. Each operation links into the corresponding Migration and Import Reference for the structural framing.
The defining property is per-site operational entry. Where the Migration and Import Reference area covers the structural model, this surface is where the operator clicks to run operations on the active site.
Purpose
Define the admin Migration surface as a Reference layer.
Scope
Covers the per-site entry surface. Does not cover the structural Migration framing (Migration and Import Reference) or per-step procedures.
What the surface offers
Run import
Trigger an import per the Import Reference.
Backup index
View the per-site backup history; trigger restore (per Backups Reference).
Search and replace
Run a bulk content/URL replacement (per Search and Replace Reference).
Validation queue
Track the post-migration validation cycle for the active site (per Post Migration Reference).
Site · Your Site · SG-Admin · Migration
Per-site entry
Run import
Bring records in from external source
Open import →Backup index
14 snapshots · last 2h ago
Open backups →Search and replace
Bulk content cleanup
Open S&R →Validation queue
3 post-migration checks pending
Open queue →Constraints and boundaries
The SG-Admin Migration surface is a Reference area for per-site migration entry.
Do not use for: structural framing (Migration and Import Reference), per-step procedures (Guides), per-release shipped change.
Public boundary
Public-safe.
Examples
Example 1 — Operator runs an import
Operator opens Migration, clicks Run Import, configures source. The import per Import Reference runs against the active site (staging).
Example 2 — Operator triggers an on-demand backup before a deploy
Operator opens Backup index, triggers on-demand snapshot. The snapshot becomes the rollback target.
Example 3 — Operator runs validation cycle after import
Operator opens Validation queue, walks through the Post Migration cycle for the recently-completed import.
Documentation guidance
Use this page as the structural definition for the per-site Migration entry. Per-operation detail lives in the Migration and Import Reference area.
Reading order
Open this page when running migrations on a site. Pair with Migration and Import Overview for end-to-end framing.
Related reading
Vocabulary cross-reference
- Per-site entry — the admin operational surface for migration.
- Reference area — the structural Migration and Import Reference framing.
- On-demand backup — operator-triggered snapshot before high-stakes operation.
Maintenance discipline
When the admin Migration surface changes across releases, update this Reference.
Related reading
| Topic |
|---|
| SG-Admin |
| Migration and Import |
| Import |
| Backups |
