The Divi 5 Migrator System checks your website’s compatibility with Divi 5 and provides key information to ensure a smooth upgrade.
This article guides you through using the Migrator System to transition your Divi 4 site to the Divi 5 Alpha.
What does the Migration process do?
When the Migrate This Site to Divi 5 Alpha button is clicked, behind the scenes, the modules that are supported by Divi 5 Public Alpha will be automatically converted to the new Divi 5 framework, which doesn't use shortcodes. Instead, it uses a modern storage format that is similar to WordPress's block editor.
The modules that are not fully supported will continue to work by being wrapped into the Divi 4 Framework.
⚠️ Note: If a page contains any module not supported by Divi 5 Alpha, the Divi 4 framework will be loaded for that page, potentially affecting performance. Pages using only Divi 5 Alpha supported modules will maintain performance with no speed impact.
Example of a supported Divi 4 module conversion
A Divi 4 module is built and rendered using shortcodes. For example, the Text module, which has a red Background Color and white text, looks like this:
[et_pb_text _builder_version=”4.27.0″ _module_preset=”default” theme_builder_area=”post_content” background_color=”#E02B20″ text_text_color=”#FFFFFF” hover_enabled=”0″ sticky_enabled=”0″]
Exercitation dolor dolore dolore reprehenderit eiusmod in tempor ad nulla cillum. Nulla sunt velit dolore dolore consequat velit aliquip sit nostrud laborum. Laboris pariatur ullamco incididunt eiusmod in nisi ex irure aute ex amet velit ullamco sint. Occaecat labore incididunt sit est sit minim eiusmod. Quis duis magna labore sint cillum velit consectetur. Commodo ullamco nisi excepteur sunt ipsum laboris ex. Minim consequat nulla quis exercitation ipsum id labore aliquip velit occaecat consequat. Ex minim pariatur nulla laborum est quis nisi proident amet irure minim consequat magna minim incididunt.
[/et_pb_text]
Since the Text module is supported in Divi 5 Public Beta after the conversion, the module will look like this:
<!-- wp:divi/text {"builderVersion":"4.27.0","modulePreset":"default","themeBuilderArea":{"desktop":{"value":"post_content"}},"module":{"decoration":{"background":{"desktop":{"value":{"color":"#E02B20"}}}}},"content":{"decoration":{"bodyFont":{"body":{"font":{"desktop":{"value":{"color":"#FFFFFF"}}}}}},"innerContent":{"desktop":{"value":"<p>Exercitation dolor dolore dolore reprehenderit eiusmod in tempor ad nulla cillum. Nulla sunt velit dolore dolore consequat velit aliquip sit nostrud laborum. Laboris pariatur ullamco incididunt eiusmod in nisi ex irure aute ex amet velit ullamco sint. Occaecat labore incididunt sit est sit minim eiusmod. Quis duis magna labore sint cillum velit consectetur. Commodo ullamco nisi excepteur sunt ipsum laboris ex. Minim consequat nulla quis exercitation ipsum id labore aliquip velit occaecat consequat. Ex minim pariatur nulla laborum est quis nisi proident amet irure minim consequat magna minim incididunt.</p>"}}}} --><!-- /wp:divi/text -->⚠️ Note: The example above won't be visible on the front end of your website because the conversion occurs at the database level.
However, the Text module (in this case) will be converted to the new Divi 5 Framework and will function as expected.
Running the Divi 5 Migrator on an existing Divi site
When you first install the Divi 5 Public Alpha on an existing Divi website, you will be greeted by the Divi 5 Migrator System.
⚠️ Important Notes:
We do not recommend using Divi 5 Public Alpha on a live production site. Instead, test it in a staging environment or on a local host installation. As Divi 5 is still under active development, you may experience bugs and incomplete features.
During the Public Alpha Phase, third-party products from the Divi Marketplace and some Divi 4 features, like WooCommerce modules, won't be fully supported.
Unsupported modules migrated with the Divi 5 Migrator System will run in compatibility mode, which has some limitations.
Divi 5 Migrator System will perform a few actions:
It will scan your website and check if you are using any Divi 4 features or third-party modules not natively supported by the current version of Divi 5.
It will generate a report about which pages, Theme Builder templates, Woo Products, Divi Library items, and WordPress Widgets on your website are affected, if any.
The Divi 5 Migrator system will show 9 different sections. Each section is responsible for displaying compatibility details regarding different areas of your website: Pages, Posts, Theme Builder templates, and much more.Migrate This Site to Divi 5 Alpha. It will allow you to migrate the existing Divi 4 content to the Divi 5 framework.
Proceeding with the update will initiate a migration process, which will convert all compatible Divi 4 modules to the Divi 5 format and wrap unsupported modules into shortcodes in the Divi 5 format so that they can continue functioning using the legacy Divi 4 framework.
Clicking on the Migrate This Site to Divi 5 Alpha button will prompt you with a confirmation message.
Clicking on the Confirm button will proceed with the migration, migrating everything to the Divi 5 framework. Once the Migration process is complete, a Green Card will be displayed:
At this point, you can restore your Divi 4 content by clicking on the Restore Divi 4 Content button. For more information, please check the How to Rollback to Divi 4 article.
Running the Divi 5 Migrator on a Divi website that contains only modules and features supported by Divi 5 Public Alpha
When you first install Divi 5 Public Alpha on an existing Divi website, which contains only modules and features that Divi 5 Public Alpha supports, and you check the Divi 5 Migrator page, you will be prompted with a Blue Card, which gives you the option to migrate/convert the existing Divi 4 content to the new Divi 5 framework.
Clicking on the Upgrade This Site to Divi 5 Alpha button will activate all the new Divi 5 Framework's supported modules and features. Once the upgrade process is complete, a new Green Card will be displayed, providing a brief explanation regarding the website's status and also providing the option to revert to Divi 4 content:
