Use an AI agent to migrate your WordPress site to Wix Headless. Wix Headless gives you Wix's built-in business tools, including a store, blog, CRM, and more, behind a frontend you control.
The Wix migration skill handles the move: it discovers your site's content, maps it to Wix equivalents, and imports your products, orders, blog posts, customers, and media into a new Wix project.
Note: WordPress migration is in Developer Preview. The feature is functional but still evolving. We welcome your feedback.
When the migration is complete, you get:
Moving to Wix means:
During the discovery phase, the skill inspects your site and determines what to migrate based on your WordPress setup and the plugins you've installed. The mapping is presented for your review before any data is imported.
The following are common content types and their Wix destinations. The skill may migrate additional content types depending on your WordPress setup:
| WordPress content | Wix destination |
|---|---|
| WooCommerce products, categories, tags, attributes | Wix Stores |
| WooCommerce product reviews | Wix CMS |
| WooCommerce orders | Wix eCommerce Orders |
| WooCommerce customers | Wix Members + Wix CRM |
| WooCommerce coupons | Wix Coupons |
| Blog posts, categories, tags, comments | Wix Blog |
| Standalone pages such as About and Contact | Wix CMS (optional) |
| Media (images, video) | Wix Media Manager |
| 3rd-party plugin content such as events and podcasts | Wix CMS collections |
The following content is not transferred as part of the migration flow:
| Content | Notes |
|---|---|
| Payment configuration | Set up payment methods manually in your Wix dashboard after the migration. |
| Historical analytics | Traffic stats, page views, and visitor counts are not transferred. |
| URL redirects | Old WordPress URLs won't automatically redirect to your Wix site. Set up redirects manually to preserve inbound links and search rankings. |
Some content is migrated with partial or reduced accuracy due to differences between WordPress and Wix:
| Content | What happens |
|---|---|
| Blog categories | Wix Blog categories are flat. Nested WordPress blog categories lose their hierarchy. |
| Variable products | Products with multiple options such as size and color may be imported as a single variant at base price if the full variant matrix can't be resolved in one pass. |
| Subscription products | Products with malformed or missing subscription cadence data may be deferred and require manual setup in your Wix dashboard. |
| Member passwords | Passwords are not imported. Imported members set a new password via the forgot-password flow. |
Key defaults and behaviors to be aware of before you start:
| Behavior | Default | Notes |
|---|---|---|
| Destination | Configurable | Choose whether to include a Wix-managed headless frontend as part of the migration. See Step 3. |
| Target site | New site | If you specify that you want a site, it creates a new Wix headless site. You can also target an existing Wix headless site by specifying it in your prompt. |
| Dry run | Off | To preview the migration without writing any data to Wix, ask your agent to run in dry run mode first. |
| Resumable | Yes | If the migration is interrupted, re-running picks up where it left off. |
Make sure you have:
Create a new local directory for your headless project.
Open the directory in your AI agent and ask it to add the migration skill to your project:
The agent downloads the skill into your project directory. The skill stays in your repository, so you can continue building and iterating after the migration completes.
To enable the Wix-managed headless frontend option in Step 3, also add the headless skill to your project:
Alternatively, you can install the Wix Plugin.
Prompt your agent to migrate your WordPress site. The simplest form is your site URL:
Your agent asks a series of questions before starting. For details, see Step 3. To skip some questions, include your preferences up front. For example:
You can configure the migration either by including your preferences in your initial prompt (see Step 2) or by waiting for the agent to ask you as it runs. For each choice, you can select one of the presented options or select Other to specify something different.
Do you want the migration to build a frontend?
| Option | What it does |
|---|---|
| Wix-managed headless site | Migrates your content and builds a custom Wix-managed Astro site, hosted by Wix. Your AI agent scaffolds the frontend and can customize the design on demand. |
| Backend only | Migrates your content into Wix without building a frontend. You can add a frontend later. |
How much of the site data should this migration include?
| Option | What it does |
|---|---|
| Public content only | Migrates publicly accessible content: products, posts, pages, categories, and media. Good for a quick run to preview what the migration produces before committing to a full import. |
| Include private & authenticated data | Migrates everything, including draft posts, private products, customer/order data, and other content that requires WordPress credentials. Use this when you're ready for a full migration. Requires a WordPress application password. |
If you chose Include private & authenticated data, the agent asks for your WordPress username and an application password.
To generate an application password:
Enter your username and the application password when prompted.
Note: Application passwords expire. If your migration spans multiple sessions, generate a new one when you resume.
How should WordPress comments be migrated?
| Option | What it does |
|---|---|
| Anonymize author details | Imports comments but replaces commenter names and emails with anonymized placeholders. Safer for GDPR compliance. |
| Skip comments entirely | Doesn't import any comments. Best if comments aren't a priority for your migrated site. |
Note: If your site has blog posts, comments are imported as a separate pass after posts are published.
When member accounts are created in Wix during import, should Wix send them a welcome/notification email?
| Option | What it does |
|---|---|
| No: suppress notifications (Recommended) | Members are created silently. They won't receive unexpected emails from a Wix site they don't recognize yet. Remember to re-enable notifications before you go live. |
| Yes: send notifications | Wix emails each imported member when their account is created. |
How should WordPress Pages (non-blog, non-product pages like About, Contact, etc.) be handled?
| Option | What it does |
|---|---|
| Import as Wix CMS content | Page content is migrated into Wix CMS collections so it can be managed and served via Wix APIs. |
| Skip pages | Pages aren't imported. Useful if you plan to build new pages manually in Wix. |
The agent asks you to confirm the Wix account where the new site will be created. Review the account shown and confirm before the agent continues.
After discovering your site's content, the agent presents a Mapping Review Checkpoint. This shows a table of every source entity, its Wix destination, how many records will be migrated, and a reliability rating.
It also lists key gaps, places where WordPress and Wix don't map exactly. Common examples:
Read through the mapping and ask your agent to make changes if needed. When you're satisfied, confirm to continue.
Before importing any data, the agent presents an Execution Plan that requires your approval before the agent implements the migration. The plan lists, in order:
Reply "approved" to start the import, or ask your agent about anything in the plan first.
The agent runs the migration, which may take several hours. When complete, it presents a final report listing any steps that require manual action in your Wix dashboard.
Once the migration is complete:
With your site live, you can:
WordPress migration is in Developer Preview. We're actively looking for feedback and are happy to support you through your migration. Reach out to us on the Wix Headless Discord channel.
Last updated: 27 August 2026