Skip to main content

WordPress import

WordPress import reads a WordPress export file (WXR/XML) and writes selected posts, pages, and comments into the main site or an author space. It has no public routes.

Authors can import into their own space. Superadmins can choose Root (the main site) or another author space. The preview shows publication states, duplicate paths, page parents, image matches, comment states, missing uploads, converted videos, and WordPress shortcodes before any content is written.

Browser imports run in resumable batches. For large exports, use the wordpress-import CLI command. Existing tinymash entries are not silently overwritten.

Recognized WordPress menus can be mapped to the site Primary and Footer locations when menu import is selected. This changes site-level navigation regardless of the content target, so review the menus after import.

Supported WordPress galleries become native Photos galleries when their attachments can be imported. Single-image caption wrappers keep the image and caption text. Paired code and php shortcodes become inert code blocks, simple highlight text becomes emphasis, and supported xs_wikipedia forms keep their words without guessed links. The preview lists these conversions; galleries with missing source images retain visible inline slots and missing-image placeholders. A Content needing review section lists remaining plugin tags and affected entries before and after import, with a downloadable full checklist. CLI users receive the findings in terminal output. Unknown tags remain in content for the operator to edit or unpublish.

Recognized HTTPS YouTube iframes become click-to-load [embed] shortcodes. Other safe iframe sources become links; unsafe sources are removed. Preview and report list these outcomes for review.

Comment import is optional and limited to comments mapped to entries in the same import. Approved comments enter moderation unless approval preservation is selected separately. Valid private e-mail retention is another separate choice; commenter addresses never create subscriptions. Commenter URLs, IP addresses, user-agent data, and reply-notification consent are not imported. WordPress users, widgets, themes, and general settings are not imported.

See Importing from WordPress for preparation, commands, media handling, replacement options, and verification.