Lyzant logoLyzant

WordPress to Medusa migration for content-led commerce

Keep WordPress where it helps content teams, move commerce workflows to Medusa, and rebuild the storefront around clean APIs, checkout control, and launch-safe redirects.

Last updated: June 2, 2026

Open source

WordPress is GPL-licensed software.

REST API

Posts, pages, media, users, and more expose JSON endpoints.

Content first

Keep editorial workflows while moving commerce control.

Headless-ready

Use WordPress as content source and Medusa as commerce backend.

Separate content risk from commerce risk

WordPress can remain a strong editorial system while Medusa takes over commerce operations. The migration work is deciding what belongs where.

Content inventory

Posts, pages, media, taxonomies, authors, menus, metadata, and high-value landing pages are mapped before rebuild.

URL and redirect planning

WordPress routes, ecommerce routes, canonical URLs, slugs, and redirects are documented before launch.

Commerce separation

Checkout, catalog, cart, customer, order, and fulfillment workflows move into Medusa instead of plugin logic.

Plugin and theme risk

Plugin behavior, shortcode output, theme templates, forms, SEO tools, and analytics are reviewed before migration.

What moves, stays, or gets rebuilt

A WordPress migration is not always an all-or-nothing move. We define a clean boundary between content, storefront, and commerce operations.

Content architecture

Posts, pages, custom post types, media, taxonomies, authors, navigation, metadata, and editorial workflows.

Commerce workflows

Product data, cart, checkout, customer accounts, orders, discounts, shipping, tax, and fulfillment behavior.

API and integration layer

WordPress REST API, Medusa APIs, CMS sync decisions, analytics events, CRM, payment, shipping, and operational tools.

SEO and launch controls

Redirects, canonical handling, metadata, sitemap updates, content parity, analytics checks, and post-launch monitoring.

A staged path from WordPress to Medusa

The plan should protect both editorial traffic and revenue paths: content parity, redirects, checkout testing, and monitoring before launch.

1

Inventory

Map content, commerce flows, plugins, routes, APIs, analytics, integrations, and launch risk.

2

Decide

Choose what remains in WordPress, what moves to Medusa, and what becomes storefront logic.

3

Rebuild

Create Medusa workflows, storefront routes, content fetches, checkout behavior, and integrations.

4

Validate

Compare content, test checkout, verify redirects, review metadata, and run launch checks.

5

Launch

Switch traffic with monitoring, rollback decisions, post-launch fixes, and stabilization support.

Turn WordPress into a content source, not a commerce bottleneck

WordPress can continue serving editorial teams while the storefront reads content and Medusa handles catalog, cart, checkout, orders, and customer workflows.

  • REST API content fetching
  • Custom post type decisions
  • Media and metadata mapping
  • Commerce plugin replacement
  • Storefront route planning
  • Analytics and SEO checks

Architecture handoff map

Each WordPress responsibility gets a clear destination so content and commerce can evolve independently.

WordPress posts and pages
Content source for editorial routes
Media library
Image and asset references for the storefront
Custom post types
Structured content models or CMS migration candidates
WooCommerce/plugin commerce
Medusa catalog, cart, checkout, orders, and workflows
Theme templates
Next.js storefront components
SEO plugins and redirects
Route metadata, sitemap, and redirect plan

WordPress constraints, Medusa outcomes

WordPress is useful for publishing. Medusa gives commerce teams a separate system for custom checkout, integrations, operations, and long-term platform growth.

Estimated monthly cost
Often $40-$250+/mo after hosting, premium plugins, security, backups, and maintenance; complex commerce can cost more.
Can start around $10/mo for a very small self-managed Medusa setup, then increases with hosting, services, integrations, support, traffic, and operational scope.
Content workflow
Strong editorial workflow inside WordPress.
WordPress can stay as CMS while Medusa owns commerce.
Commerce logic
Often depends on WooCommerce, plugins, snippets, or theme behavior.
Commerce workflows are explicit modules, APIs, and integrations.
Storefront
Tied to theme architecture unless rebuilt headlessly.
Composable storefront with separate content and commerce data.
SEO migration
Existing routes and metadata must be carefully preserved.
Routes, metadata, redirects, and content parity can be planned explicitly.
Operations
Admin experience spans WordPress plus plugins.
Commerce operations can use Medusa admin and custom workflows.

Content audit

Understand WordPress content, media, routes, plugins, metadata, and ecommerce dependencies.

Features

  • Content inventory
  • API and data map
  • URL and SEO plan

Commerce rebuild

Move catalog, checkout, orders, customers, and integrations into Medusa workflows.

Features

  • Medusa architecture
  • Integration contracts
  • Checkout replacement

Launch support

Run content checks, redirect validation, checkout tests, monitoring, and stabilization fixes.

Features

  • Dry-run migration
  • Rollback checkpoints
  • Post-launch fixes

Frequently AskedQuestions.

Answers for teams planning a WordPress to Medusa.js migration.