> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Migrate Your WordPress Site to Wix Headless

## Article: Migrate Your WordPress Site to Headless

## Article Link: https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/get-started/migrate-your-word-press-site-to-wix-headless.md

## Article Content:

# Migrate Your WordPress Site to Wix Headless

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](https://github.com/wix/skills/blob/main/skills/wix-replatform/SKILL.md) 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.

<blockquote class="caution">

**Note:** WordPress migration is in **Developer Preview**. The feature is functional but still evolving. We welcome your [feedback](#contact-us).

</blockquote>

When the migration is complete, you get:

- A [Wix site dashboard](https://support.wix.com/en/article/about-your-wix-dashboard) to manage your migrated business. Add and update store products, booking services, blog posts, forms, members, and more. No code required. Changes you make in the dashboard appear on your live site automatically. You can also [connect payment methods](https://support.wix.com/en/article/accepting-payments-an-overview) and [invite collaborators](https://dev.wix.com/docs/go-headless/project-management/invite-collaborators.md).
- If you choose to include a frontend: a [Wix-managed headless site](https://dev.wix.com/docs/go-headless/wix-managed-headless/about-wix-managed-headless.md), which is a custom frontend built and hosted by Wix as part of the migration. Your AI agent scaffolds it and can customize the design on demand.

Moving to Wix means:

- **Built-in business tools:** A store, blog, and CRM are built in and maintained by Wix.
- **Predictable hosting costs:** Wix handles hosting, infrastructure, and scaling with transparent pricing.
- **One platform, not many APIs:** Your business data lives in a single backend with consistent APIs.
- **Managed infrastructure:** Wix handles patching, scaling, and uptime so you can focus on your business.
- Wix manages platform security and keeps your infrastructure up to date.
- **Fast migration:** Migrating with an AI agent takes less than a day.

## What the skill migrates

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.

### Migrated content

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](https://dev.wix.com/docs/api-reference/business-solutions/stores/introduction.md) |
| WooCommerce product reviews | [Wix CMS](https://dev.wix.com/docs/api-reference/business-solutions/cms/introduction.md) |
| WooCommerce orders | [Wix eCommerce Orders](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/orders/introduction.md) |
| WooCommerce customers | [Wix Members](https://dev.wix.com/docs/api-reference/crm/members-contacts/members/introduction.md) + [Wix CRM](https://dev.wix.com/docs/api-reference/crm/members-contacts/contacts/introduction.md) |
| WooCommerce coupons | [Wix Coupons](https://dev.wix.com/docs/api-reference/business-solutions/coupons/coupons/introduction.md) |
| Blog posts, categories, tags, comments | [Wix Blog](https://dev.wix.com/docs/api-reference/business-solutions/blog/introduction.md) |
| Standalone pages such as About and Contact | [Wix CMS](https://dev.wix.com/docs/api-reference/business-solutions/cms/introduction.md) (optional) |
| Media (images, video) | [Wix Media Manager](https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/introduction.md) |
| 3rd-party plugin content such as events and podcasts | [Wix CMS collections](https://dev.wix.com/docs/api-reference/business-solutions/cms/introduction.md) |

### Not migrated

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. |

### Limitations

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. |

### How the skill works

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](#step-3--configure-your-migration). |
| 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. |

## Before you begin

Make sure you have:

- [Node.js](https://nodejs.org/en/) v20.11.0 or higher.
- [Git](https://git-scm.com/) installed and configured.
- A Wix account. [Sign up](https://manage.wix.com/account/custom-apps) if you don't have one yet.
- An AI coding agent such as Claude Code, Cursor, or Codex.

## Step 1 | Set up your project

1. Create a new local directory for your headless project.

2. Open the directory in your AI agent and ask it to add the migration skill to your project:

   ```text
   Install the skill from https://github.com/wix/skills/blob/main/skills/wix-replatform/SKILL.md
   ```

   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.

3. To enable the Wix-managed headless frontend option in Step 3, also add the headless skill to your project:

   ```text
   Install the skill from https://wix.com/headless/skill.md
   ```
   Alternatively, you can install the [Wix Plugin](https://dev.wix.com/docs/go-headless/get-started/headless-ai-toolkit.md#install-the-wix-plugin).
## Step 2 | Write your migration prompt

Prompt your agent to migrate your WordPress site. The simplest form is your site URL:

```text
Migrate https://yoursite.com
```

Your agent asks a series of questions before starting. For details, see [Step 3](#step-3--answer-the-agents-questions). To skip some questions, include your preferences up front. For example:

```text
Migrate https://yoursite.com to a new Wix site. Include public data only. Create a Wix site.
```

## Step 3 | Configure your migration

You can configure the migration either by including your preferences in your initial prompt (see [Step 2](#step-2--write-your-migration-prompt)) 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.

### Frontend

**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](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/about-the-astro-integration.md), 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. |

### Data scope

**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. |

### WordPress credentials (private data only)

If you chose **Include private & authenticated data**, the agent asks for your WordPress username and an application password.

To generate an application password:

1. In your WordPress admin, go to **Users** > **Profile**.
2. Scroll to the **Application Passwords** section.
3. Enter a name for the password and click **Add Application Password**.
4. Copy the generated password. WordPress shows it once, so save it somewhere safe before closing the page.

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.

### Comments

**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.

### Member emails

**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. |

### WordPress pages

**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. |

### Confirm your Wix account

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.

## Step 4 | Review the content mapping

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:

- Blog category hierarchy is dropped as Wix Blog categories are flat.
- Member passwords aren't imported. Members will need to use "forgot password" to log in to the new site.

Read through the mapping and ask your agent to make changes if needed. When you're satisfied, confirm to continue.

## Step 5 | Approve the execution plan

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:

- **Setup steps**: installing Wix apps, creating CMS collections, configuring extended fields, and deleting demo content that Wix seeds automatically.
- **Import steps**: each entity type, in dependency order. For example, categories are imported before products.
- **What won't be done**: known limitations such as unsupported content types or data that can't be transferred.

Reply **"approved"** to start the import, or ask your agent about anything in the plan first.

## Step 6 | Complete the migration

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:

1. Open your [Wix dashboard](https://www.wix.com/my-account) to review your migrated content and complete any remaining setup steps, such as connecting payment methods and configuring shipping.
2. If you suppressed member notifications, ask your agent to re-enable them before going live.
3. Transfer your domain. Domain transfer is not handled by the migration skill. Connect your WordPress domain to your new Wix site manually from your domain registrar.

## Next steps

With your site live, you can:

- In your [Wix dashboard](https://www.wix.com/my-account), install apps, set up automations, invite collaborators, and more.
- Continue designing and developing your frontend in the same repository, using the [Wix Headless skill](https://wix.com/headless/skill.md).
- [Install the Wix plugin](https://dev.wix.com/docs/api-reference/articles/ai-tools/about-the-wix-plugin.md) so your agent understands Wix workflows and can call Wix APIs directly.
- [Add extensions to your project](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/extensions/about-extensions.md).

## Contact us

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](https://discord.gg/47gUT9KabP).

## See also

- [About Wix-Managed Headless](https://dev.wix.com/docs/go-headless/wix-managed-headless/about-wix-managed-headless.md)
- [Featured Business Solutions for Wix Headless](https://dev.wix.com/docs/go-headless/business-solutions/featured-business-solutions.md)
- [Headless AI Toolkit](https://dev.wix.com/docs/go-headless/get-started/headless-ai-toolkit.md)
- [Build with an AI Agent](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/get-started/build-with-an-ai-agent.md)