If you want to migrate Divi 4 to Divi 5, the biggest change is that Divi 5 replaces the shortcode system Divi 4 has used for years. The builder is faster, the content format is cleaner, and new Divi features will only ship for Divi 5 from here on.

If you run a WooCommerce store on Divi 4 with WooExpand, you can move to Divi 5 without rebuilding your shop pages. It does take some preparation. Your product grids, carousels, and category layouts need a Divi 5-compatible version of WooExpand, and you’ll want to test everything on a staging copy before it touches your live store.

This guide covers each step: backup, updates, the migration itself, testing, and how to roll back if something breaks.

What Changes in Divi 5

Divi 5 is the next major version of the Divi theme and builder from Elegant Themes. Here’s what matters for a WooCommerce site:

• New content format. Divi 4 stores layouts as shortcodes. Divi 5 converts them to a new block-based format, which makes pages lighter and the builder quicker to load.
• Faster Visual Builder. Editing large shop and product layouts feels noticeably more responsive.
• Backward compatibility. Modules that haven’t been updated for Divi 5 still work. Divi 5 wraps them in a Divi 4 compatibility layer instead of breaking them.
• Future updates. New Divi features are being built for Divi 5 only.

That backward compatibility layer is useful, but pages that rely on it load more slowly. The goal is to have every module on your site running natively in Divi 5, and that’s why updating WooExpand comes first.

Before You Start

• Update WooExpand first. Install the Divi 5-compatible version before you run the migrator, so your WooExpand modules convert to native Divi 5 modules instead of falling back to compatibility mode.
• Back up everything. Database, files, and media.
• Use a staging site. Run the migration on a copy of your store first. Most hosts offer one-click staging.
• Check your other Divi plugins. Any extension without a Divi 5 version will run in compatibility mode.

Step-by-Step: Migrating from Divi 4 to Divi 5

Step 1: Back Up Your Website

Take a full backup of your WordPress database, themes, plugins, and media library. Store a copy somewhere other than your server.

Then create a staging site and do every step below on staging first.

Step 2: Update WooExpand to the Latest Version

You can update WooExpand in one of two ways.

Option 1: From your WordPress dashboard

1. Go to Plugins > Installed Plugins.
2. Find WooExpand.
3. Click Update Now if an update is available.
4. Confirm that WooExpand is still active once the update finishes.

Option 2: From your DiviExpand account

1. Log in to your DiviExpand account.
2. Go to Downloads and download the latest WooExpand ZIP.
3. In WordPress, go to Plugins > Add New Plugin > Upload Plugin.
4. Upload the ZIP, click Install Now, and choose Replace current with uploaded when prompted.

After updating, check that your WooExpand settings and license key are still in place.

Step 3: Update WordPress, WooCommerce, and Other Plugins

Bring WordPress core, WooCommerce, and your other plugins up to date. If you use a child theme or custom PHP, CSS, or JavaScript that targets Divi 4 markup, review it now. Selectors that depend on Divi 4’s HTML structure may need adjusting after the migration.

Step 4: Install Divi 5

Log in to your Elegant Themes member account and download the latest version of Divi 5. In WordPress, go to Appearance > Themes > Add New Theme > Upload Theme, upload the ZIP, and replace the existing Divi theme when prompted.

If Divi 5 is offered under Dashboard > Updates for your site, you can update from there instead.

Step 5: Open the Divi 5 Migrator

Go to Divi > Divi 5 Migrator.

The migrator scans your site automatically and builds a compatibility report. It checks pages, posts, Theme Builder templates, WooCommerce products, Divi Library items, presets, and widgets.

Step 6: Review the Compatibility Report

The report shows which content will convert to Divi 5 and which items will run in compatibility mode.

For a WooCommerce store, check these closely:

• Shop and category pages built with WooExpand modules
• Theme Builder templates for single products and archives
• Product pages built with the Divi Builder

If WooExpand modules show up as unsupported, you’re most likely on an older version. Go back to Step 2 before migrating.

Step 7: Run the Migration

1. In Divi > Divi 5 Migrator, review the report one last time.
2. Click Migrate This Site to Divi 5.
3. Confirm, then wait for the process to finish. Large stores can take a few minutes.

Supported content is converted to the Divi 5 format. Anything unsupported keeps working through the backward compatibility layer.

Step 8: Test Your Store

Go through the site on staging before you touch production. Start with the WooExpand modules:

• Product Grid
• Product Carousel
• Product Accordion
• Category Grid
• Category Carousel

Then test the full buying path: shop page, a product page, add to cart, cart, and checkout. Check everything on mobile and tablet, and open a few pages in the Visual Builder to confirm they edit normally.

Once staging looks right, repeat the process on your live site, ideally during a low-traffic window.

Troubleshooting Common Issues

WooExpand modules aren’t displaying

Confirm that you’re on the latest WooExpand version. Then clear your site cache and any CDN cache, regenerate Divi’s static CSS, and check the browser console for JavaScript errors.

A page is running in backward compatibility mode

That page contains at least one module that still depends on the Divi 4 framework. Check the compatibility report to find out which one, then look for a Divi 5 update from that plugin’s developer.

Layout or styling looks off

Clear all caches and regenerate CSS. Review any custom CSS that targets Divi 4 class names, and check the responsive settings on the affected modules.

The Visual Builder won’t load

Deactivate other plugins one at a time to find a conflict, and check the browser console for errors. A plugin that hasn’t been updated for Divi 5 is the most common cause.

Cart or checkout isn’t working

Check your WooCommerce settings, product visibility, and the configuration of each WooExpand module on the page. Test with a default payment method to rule out a gateway problem.

If the issue is specific to WooExpand, contact our support team and include your WooExpand, Divi, and WooCommerce version numbers.

How to Roll Back to Divi 4

If something goes seriously wrong, you have two ways back.

Option 1: Restore Divi 4 Content

Use this if you haven’t made major edits in the Divi 5 builder yet.

1. Go to Divi > Divi 5 Migrator.
2. Click Restore Divi 4 Content and confirm.
3. Wait for the restore to finish.
4. Reinstall or reactivate Divi 4 if needed.

Any changes you made in Divi 5 after migrating will be lost.

Option 2: Restore Your Backup

If you’ve already done significant work in Divi 5, restore the full backup from Step 1 (both the database and the files). Anything created after that backup was taken, including new orders on a live store, will be lost. Export recent orders first if this is your production site.

Frequently Asked Questions

Does WooExpand work with Divi 5?

Yes. The latest version of WooExpand supports Divi 5. Update it before running the migrator so your modules convert natively.

Will I lose my WooCommerce products or orders?

No. The migrator converts page layouts, not WooCommerce data. Products, orders, and customers aren’t touched. Restoring a full backup is different: it rolls back everything to the moment the backup was taken.

Can I migrate if some of my plugins don’t support Divi 5 yet?

Yes. Unsupported modules run in backward compatibility mode, but those pages load more slowly. Plan to replace or update those modules over time.

How long does the migration take?

The migration itself usually takes a few minutes. Set aside more time for testing, especially on a store with many custom layouts.

Pre-Launch Checklist

• Full backup created and stored off-server
• WooExpand updated to the latest Divi 5-compatible version
• WordPress, WooCommerce, and other plugins updated
• Divi 5 installed
• Compatibility report reviewed
• Migration completed on staging
• WooExpand modules tested
• Cart and checkout tested
• Mobile and tablet layouts checked
• Live site migrated during a low-traffic window

Ready to Move Your Store to Divi 5?

The process comes down to three things: update WooExpand, back up, and test on staging before you go live. Get those right and your shop layouts will carry over to Divi 5 with very little extra work.

Get the latest version of WooExpand and start your migration.