Reference → Migration

Migration (SG-Admin)

FieldValue
Audiencepublic
Page typereference
Areasg-admin
Updated2026-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

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

⚠ Capture a backup before high-stakes operations.

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
On this page