Skip to content
Capell CMS

Using WordPress Importer

This guide is for editors moving a site from WordPress and owners planning the migration. Every step uses the labels you see on screen. WordPress Importer runs inside Migration Assistant, so install that first.

Using WordPress Importer (editor how-to)

Section titled “Using WordPress Importer (editor how-to)”

How to connect a WordPress export

Section titled “How to connect a WordPress export”
  1. Export your content from WordPress (a WordPress export file).
  2. In Migration Assistant, start a new import and choose WordPress as the source.
  3. Provide your WordPress export.
An operator sees WordPress as an available source in the Migration Assistant import flow. An operator sees WordPress as an available source in the Migration Assistant import flow.

How to review WordPress metadata

Section titled “How to review WordPress metadata”
  1. Preview the import.
  2. Review the parsed title, body, date, categories, tags, author, permalink, and media references.
  3. Use the preserved WordPress metadata to decide how imported content should be organised after import.

How to import posts and media

Section titled “How to import posts and media”
  1. Preview the import to check the result. The preview lists the parsed posts and pages with their title, slug, status, date, categories, tags, and author.
  2. Run the import to bring across posts, pages, and media.

How to verify the import

Section titled “How to verify the import”
  1. Open the Results.
  2. Confirm posts and pages came across, and spot-check a few on the site.
  3. Check that images appear; re-import any that were skipped.
  4. Open the import session that Migration Assistant created to review the full record of what was imported.
An operator reviews the completed Migration Assistant import session and result summary created for a WordPress import. An operator reviews the completed Migration Assistant import session and result summary created for a WordPress import.

Rolling out WordPress Importer (for owners)

Section titled “Rolling out WordPress Importer (for owners)”

Turn on first

Section titled “Turn on first”
  • Migration Assistant, then a test import. Install Migration Assistant, back up, and import a few posts before bringing everything across.

Add when needed

Section titled “Add when needed”
NeedEnable
Move an entire WordPress siteA full import once a test batch looks right
Keep your old structureReview preserved category and tag metadata before running

Don’t enable yet

Section titled “Don’t enable yet”
  • Don’t run the full import until a small test batch and its media verify correctly.

Who does what

Section titled “Who does what”
RoleFirst useful screen
EditorThe WordPress import in Migration Assistant
Site ownerResults: confirm the migration is complete

Troubleshooting for editors

Section titled “Troubleshooting for editors”
What you seeWhat it meansWhat to do
WordPress isn’t offered as a sourceMigration Assistant or the importer isn’t installedInstall Migration Assistant first, then the WordPress Importer
Categories need follow-upWordPress categories and tags were preserved as metadataReview the imported content and organise it in Capell
Images are missingMedia wasn’t included or mappedConfirm media is part of the export and re-import
Some posts didn’t importThey were skipped due to errorsReview Results and re-import the affected posts