Today, Divi 5 enters the Public Beta phase, the final phase before its official release.
Divi 5 has been available for new websites for some time, but it was missing a few features that certain existing websites couldn’t live without. Those features are complete, meaning sites can migrate all their legacy Divi 4 modules to the new system and benefit from the countless new features we’ve added over the past year.
Give it a try, and let us know what you think. We’ll keep addressing your feedback before the official release.
Check out the following video to learn more. 👇
How To Use Divi 5
First, a PSA: As with any major update, especially one involving bulk conversion, it’s critical that you test Divi 5 on a staging site and back up your website before updating. With that caveat, let me show you how to access the beta and update your websites.
Downloading & Installing Divi 5
You can download Divi 5 from the downloads page in the members’ area.
You can install Divi 5 via the Themes page in your website’s WordPress dashboard. Upload it and replace your existing version of Divi.
Migrating Your Websites
Next, head to the Divi 5 Migrator.
The migrator will scan your website and give you an overview of the content that is ready to be converted. It will also let you know if you are using third-party modules from the Divi Marketplace that aren’t prepared for Divi 5.
You can proceed with the migration even if your website uses incompatible modules, but these modules won’t be converted and will run in backward compatibility mode. If your website relies heavily on third-party modules that are not ready for Divi 5, you might want to stick with Divi 4 for now.
Migrating will convert every module on your website to the native Divi 5 format. It only takes a moment. Once complete, you can visit your website and jump into the brand new version of Divi! 🙌
Divi 5 Tutorials & Help Articles
If you are new to Divi 5, we have extensive documentation in the help center and many in-depth articles on the blog and YouTube. Here are a few articles to get started with:
New Feature Tutorials
We’ve created an in-depth written tutorial and video for every new Divi 5 feature. There sure are a lot of them!
- Loop Builder
- Flexbox Layouts
- CSS Grid Layouts
- Interactions
- Design Variables
- Customizable Breakpoints
- Attribute Management
- Advanced Units
- Module Groups
- Custom Attributes
- Group Carousel
- Responsive Editor
- Relative Colors
- Nested Rows
- Option Group Presets
- Inspector
Help Articles
We’ve also written extensive documentation about everything in Divi 5. Here are some articles to get you started:
- Getting Started With Divi 5 Beta
- Migrating From Divi 4 To Divi 5
- Exploring Divi 5’s New Features
- Backward Compatibility
- Frequently Asked Questions
How To Report A Bug
Let us know if you notice any changes on your website after the migration. There may still be a few kinks to work out.
If you aren’t happy with the migration, you can restore the backup you made earlier.
If you ignored my advice and didn’t make a backup, 😡 you can restore your Divi 4 content in the migrator. Before migration, it saves a copy of all your Divi 4 content just in case.
Restore it, then reinstall Divi 4.
Public Beta 0 Changelog
This version includes the following bug fixes and improvements added since Public Alpha 24:
- Custom attributes added to presets will now merge with custom attributes set at the module level, instead of being overwritten by module-level attributes.
- When switching between modules, the settings panel will keep the active tab and option group open.
- Added a select menu to select from commonly used attributes in the attributes option group.
- Fixed carousel group buttons overlapping the add module button.
- When clicking on the layers in the layers panel, the canvas will no longer scroll to the element’s position if the element is already visible in the viewport.
- Improved the speed of adding new modules to large pages by over 50%.
- Added new arrow key keyboard shortcuts for navigating between elements on the canvas.
- Fixed Blurb module icon placement styles that did not match Divi 4 output after migration to Divi 5.
- Fixed font style resets not overriding preset styles after migrating from Divi 4 to Divi 5.
- Fixed an issue where the Menu module’s mobile dropdown menu background colors disappeared after migrating Divi 4 layouts to Divi 5.
- Fixed global sections, rows, and modules not importing correctly when exporting and importing layouts between sites.
- Added Global Modules with the Selective Sync feature, enabling automatic synchronization of reusable modules across the site while allowing per-instance customization of specific attributes. Included seamless conversion of Divi 4 global modules with preserved selective sync configurations.
- Fixed a fatal error that prevented the Block Editor from loading when editing pages using backward compatibility mode Theme Builder layouts.
- Fixed ValueExpansionFunctionMap callbacks are not triggering for third-party modules when shortcode attributes contain line breaks.
- Fixed Button module hover background colors not overriding preset values when set to match desktop background colors.
- Fixed migrated Divi 4 layouts, incorrectly receiving automatic hover/sticky transitions when no explicit transition settings were configured in the original layout.
- Fixed button icon hover animation direction in migrated D4 layouts to properly animate left-to-right instead of right-to-left, and restored icon spacing for custom icons.
- Fixed Image module absolute positioning to allow intentional overflow widths when the user explicitly sets the width value, while preserving the default max-width constraint for standard, absolutely positioned images.
- Fixed special characters like copyright symbols (©) displaying as corrupted text (u00a9) after migrating from Divi 4 to Divi 5.
- Fixed D4 to D5 migration not preserving overflow-x and overflow-y attribute values, causing unexpected horizontal scrollbars on migrated layouts.
- Fixed Pricing Table module width and layout issues when migrating D4 content to D5 or importing D4 layouts from Divi Library.
- Fixed Blog module migration issue where “Posts For Current Page” setting was incorrectly set to disabled after migrating from Divi 4 to Divi 5.
- Fixed Post Title module text colors incorrectly inverting during the Divi 4 to Divi 5 migration.
- Fixed Blog module box shadow applying to incorrect elements after D4 to D5 migration by adding conditional selector logic that targets the module wrapper for full-width layouts and individual posts for grid layouts.
- Fixed background blend modes (difference, multiply, screen, etc.) not rendering correctly after migrating D4 layouts to D5 when the background color is not explicitly set.
- Fixed WooCommerce Product Gallery grid layout to adapt to parent column widths like Divi 4, resolving images stacking vertically in narrow containers.
- Fixed specialty section column rendering in backward compatibility mode.
- Fixed the Call To Action module button background color not displaying in Theme Builder and resolved the double-prefixing issue.
- Fixed an issue where setting an opacity value in the color picker and then entering a CSS variable would remove the opacity value when pressing Enter.
- Updated Divi 5 to use a separate translation text domain (et_builder_5) to ensure proper localization without conflicts with Divi 4 translations.
- Updated .po files to include Divi 5’s newly introduced translatable strings.
- Added a command to update localization for D5 on the Divi Build process action.
- Fixed incorrect element positioning on tablet and phone breakpoints when changing from centered absolute to non-centered relative positioning.
- Fixed incorrect element positioning when changing Position and Offset Origin settings between responsive breakpoints.
- Fixed background image position and horizontal/vertical offset not working for custom breakpoints (UltraWide, WideScreen, TabletWide, PhoneWide) in both Visual Builder and Frontend.
- Fixed the Divi 4 to Divi 5 migration so that it preserves sticky settings for child modules placed inside sticky Sections.
- Fixed FontAwesome icons not displaying correctly as arrow icons in Group Carousel modules.
- Fixed the Shortcode module appearing instead of the standard section when creating new pages in VB.
- Fixed Button modules and other Divi modules failing to migrate from Divi 4 to Divi 5 when third-party plugin attributes were present by adding an extensibility filter for plugin developers to register legacy attributes.
- Fixed Button Module and custom attributes outputting empty HTML attributes that should be omitted for cleaner, more accessible markup.
- Fixed Option Group Presets not being imported during JSON layout import in Divi 5.
- Fixed CSS clamp, min, and max functions to accept values without spaces after commas and automatically format spacing for consistency.
- Fixed intermittent WooCommerce test failures by introducing specialized base classes that properly isolate REST context and session state between tests.
- Fixed WooCommerce Checkout Additional Info Module placeholder text color not applying in Visual Builder and Frontend.
- Fixed WooCommerce Checkout Information module margin and padding settings not applying in Visual Builder due to a missing CSS generation configuration.
- Fixed the WooCommerce Checkout Payment Info module background video not covering the entire module on the frontend.
- Fixed WooCommerce Checkout Payment Info module margin values applying inside the module container instead of outside.
- Fixed WooCommerce Checkout Payment Info module missing default padding (Divi 4 parity).
- Fixed WooCommerce Product Gallery line-height options not applying correctly in Visual Builder and Frontend for Title, Caption, and Pagination elements.
- Fixed the Static Module Summary field not displaying on the frontend to match the Visual Builder output.
- Fixed D4 layouts imported through Divi Library that are not being migrated to D5 format.
- Fixed WooCommerce checkout validation errors appear across all checkout modules instead of only in their relevant ones. Optimized checkout and cart module rendering by preventing unnecessary template rendering when modules should not display.
- Fixed Email Optin module background color migration when “Use Background Color” toggle is off.
- Fixed Blog Module to correctly display all posts on archive pages, including the most recent post, when using Theme Builder templates.
- Fixed Contact Form field IDs being incorrectly modified when cloning an entire form, which broke custom Message Patterns that rely on consistent field IDs across multiple forms.
- Fixed Germanized for WooCommerce plugin content appearing outside module containers in Divi 5 by implementing proper hook relocation for blocks and shortcodes.
- Fixed Divi Timeline Layout migration failing with “Legacy Modules Detected: et_pb_blurb” error by adding missing D4 list styling attributes to the legacy attributes list.
- Fixed Loop Builder using WordPress reading settings as a fallback instead of the configured default posts per page value.
- Fixed module presets not migrating from Divi 4 to Divi 5 after using “Restore Divi 4 Content” in the Divi 5 Migrator.
- Fixed Toggle modules from Divi 4 not migrating properly to Divi 5 and displaying backward compatibility warnings.
- Fixed WooCommerce checkout and cart pages showing blank content when opening Visual Builder without saving.
- Fixed the WooCommerce Product Title module heading level setting that is not applying on the frontend.
- Fixed D5 migration system to properly convert presets from multiple D4 layout imports instead of skipping subsequent migrations.
- Fixed Blog module Option Group Presets for Title Text and Meta Text, where only one preset was applying while maintaining preset classes de-duplication logic.
- Updated roadmap documentation with the latest data from GitHub (179 main roadmap items, 201 developer roadmap items).
- Added support for conditional field visibility and final query control in Loop Builder, enabling third-party developers to create advanced Loop extensions with custom fields that respond to loop settings and query modifications that persist through context processing.
- Fixed sortable list fields (checkbox options, radio options, select options) rendering as plain text inputs in Contact Field and Signup Custom Field modules, allowing proper list management with drag/drop reordering, item actions, and value persistence.
- Fixed Visual Builder filter hover reset
- filters now automatically reset on hover to ensure module options remain accessible when filters are applied.
- Fixed sticky filter effects and other sticky state attributes not migrating correctly from Divi 4 to Divi 5 when applied to child elements of sticky-positioned containers.
- Fixed parallax background rendering to match Divi 4 behavior when gradient overlay is enabled on Conference Event Landing Page layouts, and resolved section height discrepancies by correcting background class logic in Countdown Timer and Signup modules.
- Fixed custom button icons to properly inherit font-size from their parent button instead of using hard-coded values.
- Fixed module links not working when third-party DiviExtension plugins (Divi Supreme, Divi Pixel, etc.) are active.
- Fixed 404 page footer layout issues caused by missing CSS rules when using Theme Builder templates.
- Fixed the slider module’s title text not changing issue for the Phone Wide responsive breakpoint.
- Fixed Blog module column layout changes during migration from Divi 4 to Divi 5.
- Fixed Text modules from the Robotics Landing Page and Middle Eastern Restaurant Landing Page failing to migrate from Divi 4 to Divi 5 due to corrupted font size attributes.
- Fixed sticky elements that do not maintain their width and max-width dimensions when entering the sticky state due to CSS specificity.
- Fixed issue where users could manually enter invalid values outside the 1-10 range in Group Carousel “slides to show” and “slides to scroll” settings.
- Fixed gradient stop percentage values are not displayed when hovering in the background gradient settings.
- Added vw and vh viewport units support to the Letter Spacing field for responsive typography.
- Fixed WooCommerce Product Upsell module incorrectly displaying responsive controls for Product Count, Column Layout, Order, and Product Offset Number fields in VB, which are intentionally desktop-only to match D4 behavior and WooCommerce’s server-side rendering architecture.
- Fixed Dynamic Content image fields not displaying correctly when using the ACF Image return format.
- Added comprehensive Divi Marketplace compatibility labeling tutorial to help third-party developers properly configure D4/D5 product compatibility settings.
- Fixed Contact Form conditional logic rules not working correctly when importing D4 layouts into D5.
- Fixed D4 to D5 data conversion for third-party custom modules by implementing an automated conversion outline build system.
- Enhanced Module Visibility Manager by replacing localStorage with WordPress REST API persistence and refactored React components for improved reliability.
- Fixed Divi 5 checkout modules to display appropriate warnings on non-checkout pages.
- Fixed WooCommerce Checkout Payment module background styles overflowing outside border radius boundaries and corrected AGMS border selector usage.
- Fixed Theme Builder compatibility issue with the LearnDash plugin that caused fatal errors.
- Fixed WooCommerce Product Gallery image border radius and title text styling not working properly.
- Fixed missing WooCommerce checkout payment module warnings that alert users when required billing or shipping modules are not on checkout pages.
- Fixed WooCommerce Checkout Payment Module preview not displaying in Theme Builder Visual Builder.
- Fixed CSS class numbering issue where classes started with random numbers instead of 0 in WordPress 6.8 and later versions. Added inner-content rendering API and improved parsing delegation for better WordPress compatibility.
- Enhanced D4→D5 conversion allows Pop-ups for Divi attributes to be safely ignored when pop-ups are disabled, so that sections with disabled pop-ups will be converted to native D5 modules instead of shortcode modules (backward compatibility mode).
- Fixed gradient colors not migrating correctly from Divi 4 to Divi 5, preventing RGBA gradient stops from being replaced with 100% in background-image CSS.
- Fixed WooCommerce checkout page showing duplicate content on the order confirmation page when using Visual Builder or Theme Builder for checkout templates.
- Updated dynamic module tutorial with comprehensive plugin setup guidance, fixed compatibility issues, and optimized workflow for developers completing static and dynamic module tutorials.
- Fixed Menu module background color not preserving the module background during D4 to D5 migration.
- Fixed Woo Breadcrumbs module link text color not applied after D4 to D5 migration due to a missing important CSS flag.
- Fixed missing WooCommerce cart-totals script causing 404 errors in Visual Builder by updating webpack configuration to properly discover and compile scripts from nested module directories.
- Fixed the Person module custom CSS fields not applying in Visual Builder.
- Fixed sticky state styles being always active in the Visual Builder when the WordPress admin bar is enabled.
- Fixed the Map Module crashing the Visual Builder when closing the Responsive Editor with a configured Map Center Address.
- Fixed Code Module shortcodes and HTML content incorrectly showing CSS validation errors in the Inspector modal.
- Fixed a recently introduced regression in D4 to D5 conversion, where third-party legacy shortcode modules were rendered as empty placeholders instead of displaying their content.
- Fixed Loop Builder sticky posts being ignored by default when using non-date ordering options.
- Fixed unintentional stripping of custom contact form fields added by third-party plugins while preserving conditional logic placeholder removal.
- Fixed button option group presets not working on the front end.
- Fixed the Inspector not detecting group presets if it didn’t also detect a module preset within the inspected area.
- A new inspector was added to detect and bulk edit essential attributes.
- Fixed sticky element anchor scroll positioning to ignore sticky offsets when sticky positioning is disabled.
- Fixed dropdown menus in Theme Builder headers getting hidden behind sections with box-shadow applied.
- Fixed mobile menu accessibility issue on 404 pages when using the Menu Module in Theme Builder Global Headers.
- Fixed Text Module text alignment not working on custom breakpoints (tablet-wide, phone-wide) due to CSS specificity conflicts.
- Fixed D5 layout import crash when global color definitions are missing from imported layout files.
- Fixed ACF field value display issues in Loop Builder where True/False fields, User fields, and other field types were not displaying correctly.
- Fixed Option group preset defaults incorrectly, overriding custom presets when adding new modules in Visual Builder and front-end rendering.
- Fixed Visual Builder crash when deleting option group presets currently used by modules on the page.
- Fixed bug with Woo Notice position if the Theme Builder layout has the Woo Notice module.
- Fixed background video, mask, and pattern functionality in the Bar Counter module with proper parent-child inheritance.
- Fixed dynamic content functionality breaking when global modules exist inside Loop Builder sections.
- Enhanced D5 migrator with new functionality to detect and convert shortcode modules that gain D5 support after initial page conversion, enabling already-converted posts to benefit from ongoing D5 ecosystem evolution.
- Fixed Text modules with hover-only content disappear after initial hover interaction instead of remaining visible.
- Fixed WooCommerce Gutenberg checkout field settings not saving when the Divi theme is active by ensuring checkout field settings are properly registered in the WordPress REST API.
- Fixed Meta Query button alignment in Loop Builder.
- Fixed grid layout column limit to support up to 12 columns when switching from other layout types.
- Fixed custom groups not rendering in custom panels within Divi 5 module settings.
- Fixed block layout column structure modal not responding to column structure changes in Divi 5 Visual Builder.
- Fixed WooCommerce Checkout Shipping module margin and padding spacing options not applying visual effects in the Visual Builder.
- Fixed the “Use The Divi Builder” button, which incorrectly appears in Classic Editor for disabled post types.
- Fixed Form Notice text alignment controls not working in the WooCommerce Checkout Payment module.
- Fixed Form Notice Text Shadow styles not working in the WooCommerce Checkout Payment Info module.
- Optimized module registration performance by reducing JSON file operations and implementing intelligent caching for module metadata, conversion outlines, and default attributes.
- Fixed WooCommerce Product Images gallery thumbnails do not respect the border radius when CSS variables are used instead of pixel values.
- Fixed Search Module “Exclude Categories” dropdown showing empty instead of site categories.
- Fixed WooCommerce Checkout Order Details module test snapshots.
- Fixed WooCommerce Checkout Shipping Module preview display in Theme Builder Visual Builder.
- Fixed global variables and global colors being double-serialized in the database.
- Fixed portability import getting stuck at 99% due to undefined global color objects.
- Updated test snapshots for WooCommerce Checkout Payment Info module to match current styling implementation.
We’re On The Home Stretch
Developing Divi 5 has been quite a journey; now, we are on the home stretch.
Our goal is to make it official before the end of the year, and if not, soon after. Our primary focus will be fixing the migration bugs you report and any other critical issues. You can also expect a few surprise features before the end of the year.
This isn’t the end; soon, the real fun begins!
Have You Tried The Inspector?
In case you missed it, we recently released the Inspector for Divi 5. It was inspired by a similar system in Figma, and is now available for Divi, except even better. Inspect an element to get an overview of its most essential attributes, including all child elements. Then, quickly change colors, fonts, sizes, content, and presets across everything. It’s a massive time saver.
Watch this video for all the details. 👇
More Divi 5 Updates Are On The Way
2025 is the year of Divi 5. The tedious work is behind us. We built the super-fast foundation, and now it’s time for Divi to make its comeback.
If you’re here for the Divi comeback, do us a huge favor and let us know by liking this video and leaving a comment. It means a lot to us to see you cheering Divi on, and it’s essential to feed the algorithm and spread the word.
Don’t forget to follow us on YouTube and subscribe to the Divi newsletter so you never miss an update. I’ll see you soon for another Divi 5 feature announcement, which I promise will be right around the corner. 😁
Awesome. Good job so far!
Finally! Big cheers to the squad!
Major improvement in migrations with the more recent builds. Some heavily customised sites can be a bit tricky, but workarounds cover most instances. Will be impressive to see these ironed out.
Good job, but still need to add the alternative text attribute for images by default.
The loop must have exclude this post when we used it for related posts also.
Fantastic! I LOVE you guys. It’s been a long time coming, but it’s so worth the wait. My business was 100% Divi until about a year ago…now I can go back to happier times. The new, vastly improved documentation & support is very, very much appreciated. Thank you to everyone who worked on this. You should be proud of what you’ve built, You are now years ahead of the competition.