---
title: "WooCommerce to J2Commerce 6"
description: "The WordPress + WooCommerce adapter adds a WordPress lane and a WooCommerce lane to J2Commerce Migrator. It moves content, users, and store data from a WordPress source database into Joomla 6 and…"
url: "https://docs.j2commerce.com/v6/apps-and-extensions/plugins/wordpress"
markdown_url: "https://docs.j2commerce.com/v6/apps-and-extensions/plugins/wordpress.md"
last_updated: "2026-11-14T13:35:51+00:00"
version: "J2Commerce 6"
breadcrumbs:
  - title: "Home"
    url: "https://docs.j2commerce.com/"
  - title: "J2Commerce 6"
    url: "https://docs.j2commerce.com/v6"
  - title: "Apps and Extensions"
    url: "https://docs.j2commerce.com/v6/apps-and-extensions"
  - title: "Plugins"
    url: "https://docs.j2commerce.com/v6/apps-and-extensions/plugins"
  - title: "WooCommerce to J2Commerce 6"
    url: "https://docs.j2commerce.com/v6/apps-and-extensions/plugins/wordpress"
---

# WooCommerce to J2Commerce 6

The WordPress + WooCommerce adapter adds a WordPress lane and a WooCommerce lane to J2Commerce Migrator. It moves content, users, and store data from a WordPress source database into Joomla 6 and J2Commerce 6.

Use it when you are replacing a WordPress or WooCommerce site with Joomla and J2Commerce.

## Requirements

- Joomla 6.0.0 or later.
- J2Commerce 6 (`com_j2commerce`).
- J2Commerce Migrator (`com_j2commercemigrator`) 6.1.10 or later, installed and enabled.
- Source: WordPress 5.0 or later and WooCommerce 7.1 or later.
- To migrate product reviews: the J2Commerce Product Reviews app, installed and enabled.

---

## Installation

1. Install and enable J2Commerce Migrator.
2. Go to **System** -> **Install** -> **Extensions**.
3. Upload the plugin package.
4. Open J2Commerce Migrator. The **WordPress + WooCommerce** card shows **Ready to migrate**.
5. Click **Configure Connection** and enter the source database details.
6. Click **Start Migration**.

---

## Settings

The plugin has no settings of its own. It adds two pages, **WordPress Migration** and **WooCommerce Migration**, plus a **Connection** page. Each step has **Detect**, **Migrate**, **List**, and **Reset** buttons. **Migrate All WordPress Content** and **Migrate All WooCommerce Data** run every step on a page.

### WordPress Migration Page

| Section | What It Does |
| --- | --- |
| Lookup & Probe | **Probe Source** checks the connection and lists WordPress tables. **Map User Roles** assigns each WordPress role to a Joomla user group or to **Skip User (do not migrate)**. |
| Users | **Users** creates Joomla accounts using the role mapping. **User Meta** moves custom user meta to Joomla custom fields. |
| Taxonomy | **Categories** (under Blog), **Term Taxonomy**, and **Tags**. |
| Blog Posts | **Posts** become articles in the Blog category. **Post Meta** becomes custom fields. |
| Pages | **Pages** become articles in the Pages category. **Page Hierarchy** restores parent-child links. |
| Menus | **Menu Types** and **Menu Items**. |
| Uploads & Media | **Uploads** records media files. **Rewrite Body Images** changes `wp-content/uploads/` paths to `images/wordpress/` in article text. |
| Tools | **Reset Content Migration** and **Rebuild Assets & Trees**. |

### WooCommerce Migration Page

| Section | What It Does |
| --- | --- |
| Lookup & Probe | **Probe Source**, **Detect HPOS Mode**, and **Store Settings** (name, address, currency, country and state, weight and dimension units, tax behavior). |
| Tax | **Tax Classes**, **Tax Rates**, and **Tax Locations**. |
| Shipping | **Shipping Zones**, **Zone Locations**, and **Shipping Methods**. |
| Product Catalog | **Product Categories** (under Shop), **Attribute Taxonomies**, and **Attribute Terms**. |
| Products | **Products**, **Product Meta**, **Variations**, **Variation Meta**, and **Product Images**. |
| Customers | **Billing Addresses** and **Shipping Addresses**. |
| Coupons | **Coupons** and **Coupon Meta**. |
| Orders | **Ensure Order Statuses**, **Orders**, **Order Addresses**, **Order Items**, **Order Item Meta**, **Order Tax**, **Order Shipping**, and **Order History**. |
| Product Reviews | **Check Reviews App**, then **Reviews**. |
| Tools | **Reset Commerce Migration**. |

---

## How It Behaves

- WordPress password hashes are kept. They are rehashed on the user's first login.
- Orders work with both HPOS and legacy post-based WooCommerce storage.
- Run **Map User Roles** and save the mapping before you migrate users.
- Use **Empty Source** and the **Synced** label to see which steps have no rows left.
- The migration log can be exported.

> **Warning:** The reset buttons delete all adapter ID mappings and cannot be undone. Back up your database before you run **Rebuild Assets & Trees**.

---

## Common Setups

1. Click **Probe Source** on the WordPress page.
2. Map roles and save.
3. Migrate users, taxonomy, posts, pages, menus, and uploads.
4. Switch to the WooCommerce page and migrate tax, shipping, catalog, products, customers, coupons, and orders in that order.
5. Run **Rebuild Assets & Trees**.

---

## Troubleshooting

| Problem | Fix |
| --- | --- |
| "This plugin requires com_j2commercemigrator to be installed." | Install and enable J2Commerce Migrator, then install the plugin again. |
| "This plugin needs J2Commerce Migrator 6.1.10 or later." | Update the component, then install the plugin again. |
| "Resolve unmapped roles in tile AB first." | Open **Map User Roles**, assign every role, and click **Save Role Mapping**. |
| "No WordPress roles found in the source database." | Check that the connection points at a WordPress install with users in `wp_usermeta`. |
| Category or article saves fail with nested-set errors such as "Out of range value for column 'lft'". | Back up the database and run **Rebuild Assets & Trees**. |

---

## Uninstalling

1. Go to **System** -> **Manage** -> **Extensions**.
2. Search for **WordPress + WooCommerce**.
3. Select the plugin and click **Uninstall**.

Content and store data already migrated stays in Joomla.