Skip to content

Migration manager

The Migration screen appears in Studio for projects created through the website-migration flow. It summarises the migration, lets you refresh content from the source site, and reports mapping coverage. Open it from the Migration icon in the Studio nav rail.

The summary card shows:

Metric Description
Source URL The original website that was migrated, linked to the source.
Build Status Whether the initial Astro build succeeded or failed.
Pages Crawled Total number of pages discovered and crawled during the original migration.
Entries Saved Number of content entries that were saved to collections.
Coverage Percentage of crawled pages that produced a content entry.
Collections Number of content collections in the migrated project.

Click Regenerate to rebuild the report from the current state of the migration job.

The Refresh Content section re-crawls pages from the source site and updates Studio content. Use it when the source has been updated and you want to pull in the latest version.

Click Refresh All Pages to re-crawl every page that the original migration discovered. Studio queues a refresh job that:

  1. Re-crawls the original list of URLs.
  2. Extracts content using the migration agent.
  3. Updates existing entries (or creates new ones).
  4. Records the result in the refresh history.

The original migration must be in the Completed state. If a refresh is already running, the button is disabled until it finishes.

The Browse Pages tab lists every page from the original crawl. You can:

  • Search by URL.
  • Filter by collection.
  • Filter by status — Mapped (pages that produced a content entry) or Unmapped (pages that did not).

Tick the pages you want to refresh, then click Refresh Selected (N).

Switch to the Enter URLs tab to refresh URLs by hand, including pages that were not part of the original crawl. Enter one URL per line and click Refresh Entered URLs.

While a refresh is running, the screen shows an in-progress card with a status spinner and an indeterminate progress bar, and polls every two seconds. When the run finishes, the success or failure message replaces the in-progress card.

If the report includes collections, a table breaks coverage down by collection:

Column Description
Collection The collection name.
Crawled Pages assigned to this collection during the crawl.
Mapped Pages that produced an entry.
Coverage Percentage bar showing the mapping success rate.

Coverage below 90% is highlighted in amber to draw attention to collections that may need manual review.

A list of every refresh job for this migration, showing the type (full site or partial), the URL count for partial refreshes, the entries-saved count, the status, and the time the refresh was triggered.

  • Content management — review and edit migrated content
  • Content schemas — adjust the schemas produced during migration
  • Settings — brand and identity fields are prefilled from the migration when available