Overview

The Divi Migration Helper plugin includes an optional set of WP-CLI commands that provide another way to access Divi’s built-in migration engine. Instead of running the migration through the browser, advanced users can perform the same official Divi 4 to Divi 5 migration directly from the command line. This approach is particularly useful for large websites where browser, hosting, or gateway time limits can interrupt long-running migrations.

The WP-CLI commands use the same Divi conversion engine as the standard browser-based migration. They do not replace or modify Divi’s migration process. Instead, they provide a server-side interface that allows developers and agencies to preview migrations, monitor progress, identify content using Backward Compatibility Mode, roll back converted content, and even upgrade the Divi theme from the command line.

Before You Begin

This feature is intended for developers, agencies, and advanced WordPress users who are already familiar with WP-CLI. This documentation explains the WP-CLI commands provided by the Divi Migration Helper plugin, but it does not teach how to install or use WP-CLI itself.

Before running any commands, make sure:

• WP-CLI is installed and working on your server
• The Divi Migration Helper plugin is installed and activated
• You have administrator access to the WordPress site
• You have created a complete backup of your website
• You have tested the migration on a staging site whenever possible

Recommended Migration Workflow

Although each command can be used independently, we recommend following this workflow.

Upgrade Divi To Version 5

If your website is still running Divi 4, upgrade the Divi theme before migrating your content.

Check Migration Status

Use the status command to see how much content is still waiting to be migrated before making any changes.

Preview The Migration

Run a dry run first to preview what will be migrated without modifying your website.

Run The Migration

When you’re satisfied with the preview, run the migration to convert your Divi 4 content to Divi 5 using Divi’s official migration engine.

Review Backward Compatibility Mode

After the migration finishes, use the fallbacks command to identify any pages or modules that continue using Backward Compatibility Mode so they can be reviewed.

Roll Back If Necessary

If you need to restore your original Divi 4 content, use the rollback command to restore the backups created during the migration.

Available Commands

status

Displays the current migration status without making any changes to your website. This includes pending content by post type, pending legacy preset conversions, and whether the migration has been completed across the entire site. This command is useful both before starting a migration to understand what remains and afterward to verify that the migration completed successfully.

run

Runs the Divi 4 to Divi 5 migration using Divi’s official migration engine. Before making changes, you can perform a dry run to preview exactly what will be migrated. You can also migrate individual post types or process larger websites in configurable batches. Every converted item keeps a Divi 4 backup so it can be restored later if needed.

fallbacks

Reports any content that still contains modules using Divi’s Backward Compatibility Mode after migration. This helps you quickly identify which pages, layouts, or templates may need additional review and shows which module types did not convert to native Divi 5 blocks.

rollback

Restores the Divi 4 backups that were created during the migration. If you need to undo your migration for any reason, this command restores your original Divi 4 content and removes the Divi 5 migration metadata.

upgrade-theme

Upgrades the Divi theme to the latest Divi 5 version using the Elegant Themes API credentials already configured in Divi. This command is only needed when your website is still running Divi 4 before beginning the migration.

Using AI With The WP-CLI Commands

If you use AI coding assistants such as ChatGPT, Claude, Gemini, Cursor, GitHub Copilot, Windsurf, or similar tools, you can download the accompanying WP-CLI Command Reference Markdown (.md) file and upload it directly into your AI conversation.

Because the Markdown file contains the complete WP-CLI documentation—including every command, option, example, and troubleshooting guide—your AI assistant can provide plugin-specific guidance, explain commands, generate migration scripts, answer questions, and help automate migration workflows with much greater accuracy than relying on general WordPress knowledge.

Download The WP-CLI Command Reference Markdown File

This page provides an overview of the WP-CLI commands included with Divi Migration Helper. For the complete documentation, download the accompanying WP-CLI Command Reference Markdown (.md) file.

The Markdown file includes:

• Every available WP-CLI command
• All command options and arguments
• Usage examples
• Automation and scripting examples
• Troubleshooting guidance
• AI-friendly formatting for coding assistants

Upload the Markdown file into your favorite AI assistant whenever you need help with the Divi Migration Helper WP-CLI commands.