How to migrate from Divi to Gutenberg (without losing SEO)
Divi locks your layout in its own shortcodes. Moving to native WordPress blocks is a manual rebuild — here's the path that keeps your rankings.

Editorial opinion based on hands-on experience — not financial, investment, or professional advice. Some links may be affiliate links; see our disclosure.
- Divi is a builder and theme from Elegant Themes that wraps your content in its own shortcodes. Those shortcodes only render while the Divi theme or plugin is active — switch away and your pages collapse into bracketed code. That dependency is the lock-in people move to escape.
- Gutenberg, WordPress's native block editor, needs no extra plugin or theme to render your content. Moving to it means your layout lives in core WordPress, loads lighter, and survives theme and plugin changes. It's a layout you can genuinely leave.
- There is no clean Divi-to-blocks converter. Divi stores layouts in its own shortcode format that doesn't map onto native blocks, so this is a section-by-section rebuild in the editor — not an import. Be honest with yourself about that scope before starting.
- What protects your traffic is keeping every URL identical and stripping leftover Divi shortcodes after you switch away. Rebuild on a staging copy first — Cloudways and similar managed hosts make staging one click — so the live site stays untouched until it's ready.
01Why leave Divi for native blocks
Divi is powerful and popular, and its lifetime license made it a default choice for a lot of sites. It works well — right up until you want to leave it. Then you discover your content is wrapped in Divi's own shortcodes, and the layout you built isn't really yours; it belongs to Divi.
That's the heart of the lock-in. Switch off the Divi theme or builder and your pages turn into walls of Divi shortcode. You carry Divi's CSS and JavaScript on every page load, and your whole site depends on one company's product staying installed and maintained. Native blocks remove that dependency entirely.
What moving to Gutenberg actually changes
- No theme or plugin dependency. Blocks are built into WordPress core, so your layout doesn't hang on Divi staying installed, updated, or supported.
- Lighter pages. Divi loads a substantial framework of its own. Native blocks render much closer to plain WordPress, which usually means faster loads.
- Portability. Block content is stored as clean, standard markup in the post. Change themes or hosts and it travels with you — the opposite of the lock-in you're leaving.
- A free hand with themes. Off Divi, you can pick any block theme you like instead of being tied to the Divi theme's look and limits.
None of this makes Divi bad software — plenty of people are happy on it. It means that once portability and speed matter to you, owning a layout that lives in core WordPress is worth a one-time rebuild to reach.
02The honest reality: this is a rebuild, not a converter
Here's what most cheerful guides leave out. There is no reliable tool that turns Divi layouts into clean Gutenberg blocks. Divi stores everything in its own shortcode format, and nothing converts that faithfully into native blocks. So a Divi-to-Gutenberg move is a rebuild you do by hand, one page at a time.
A few plugins advertise builder-to-block conversion. At best they lift plain text and some images across; Divi's rows, modules, and design settings don't make the trip intact. Treat any converter as a rough head start, never a finished result, and inspect every page it produces before trusting it.
The silver lining is the clean slate. Divi sites often accumulate heavy sections and unused modules over the years. Rebuilding in native blocks lets you shed that weight and land on a lighter, faster, tidier site than the Divi one you left. Expect to recreate, not convert, and the work stops being a struggle.
| Element | Converts cleanly? | What to expect |
|---|---|---|
| Body text and headings | Mostly | Plain text maps to Paragraph and Heading blocks; recheck levels |
| Images | Partly | Often need re-inserting; confirm they pull from the media library |
| Rows and columns | Rarely | Rebuild with the Columns and Group blocks by hand |
| Divi modules | ✗ | Recreate with core blocks or a lightweight block plugin |
| Divi theme builder and global styles | ✗ | Rebuild in a block theme or its settings |
03Pre-flight: back up and build on staging
Never rebuild on the live site, and never begin without a backup you've actually tested. Because this touches every page and may involve switching themes, the two things that keep you safe are a restorable backup and a private staging copy to work in away from visitors.
Take a full backup of files and database, then restore it somewhere to prove it works — an untested backup is only a hopeful file. Then clone the site to a staging environment. That's where you rebuild, swap away from the Divi theme if you're using it, and confirm everything before any of it goes public.
Get your safety net in place
- Take a full backup of files and database and test the restore on a throwaway copy before touching anything.
- Create a staging site — a private clone where the whole rebuild happens, keeping the live site untouched until launch.
- Note your current setup: Divi version, whether you use the theme or the builder plugin, and any child theme, in case you need to revert mid-rebuild.
- Screenshot every page at desktop and mobile widths first, as both a rebuild reference and a before/after comparison.
Managed WordPress hosts make this painless. Cloudways and similar give you one-click staging plus automated backups, so you can clone, rebuild on the copy, and go live only when it's right. We point readers to Cloudways for this staging-and-backup workflow, though several managed hosts offer something comparable.
04Rebuilding your pages in blocks, section by section
With staging ready, the rebuild is methodical rather than hard. You work one page at a time, recreating each Divi section as native blocks while the Divi version is still live to copy from. Don't switch away from Divi until every page has a block-built equivalent.
Open the existing Divi page in one tab and a fresh block-editor draft of the same page in another. Move down the page section by section, recreating each piece with the closest native block: a Divi section becomes a Group, a multi-column row becomes a Columns block, a hero with a background becomes a Cover block.
The blocks that replace common Divi modules
- Columns block for any Divi row with multiple columns — it's the workhorse of the whole rebuild.
- Cover block for Divi sections with a background image and overlaid text, replacing Divi's section backgrounds.
- Group block to wrap a set of blocks with shared spacing or a background, mirroring a Divi section or row.
- Heading, Image, and Buttons blocks for everyday modules — and a lightweight block-library plugin only if you genuinely miss a specific Divi module.
Don't chase pixel-for-pixel fidelity. Match the structure and the feel, then move on. A clean block layout you can maintain beats a fragile copy of a Divi design — and you'll usually find the native version loads faster and reads cleaner once Divi's framework is gone.
05Keeping your URLs and SEO intact
This is the step that protects your Google traffic, and because you're staying on WordPress, it's simpler than a platform move. Your URLs don't need to change at all — and they shouldn't. The goal is a rebuild Google never notices in your address bar.
You're rebuilding the same pages on the same site, so keep each slug exactly as it was. Don't rename pages, don't restructure permalinks, don't move things around. When a URL stays identical and the content stays equivalent, there's nothing for search engines to drop.
Protect the signals search engines read
- Keep every slug and permalink unchanged, so there are no redirects to manage and no ranking risk from new addresses.
- Preserve the heading structure. Rebuild the same H1, H2, and H3 hierarchy in blocks — search engines read headings, and Divi's were doing a job.
- Leave your SEO plugin's data alone. Yoast or Rank Math store titles and descriptions on the post, not in Divi, so they carry over untouched if the slug doesn't change.
- Re-check internal links and images so nothing points at a Divi-generated asset URL that disappears when you switch away.
If you decide to tidy a few URLs while you're in there, that's fine — but it stops being free. Each changed URL needs a 301 redirect from the old address to the new one, or that page loses the rankings it had. The safe default is simply to leave your URLs exactly as they are.
06Tools and plugins that help (and what's still manual)
A few tools take the edge off, but be honest about their limits. The bulk of Divi shortcode cleanup and the section-by-section rebuild stay manual no matter what any migration plugin promises on its landing page.
- Builder-to-block converter plugins can lift plain text and some images into blocks as a rough start. Verify every page — Divi's modules and rows rarely survive.
- A block-library plugin (a lightweight one) covers any specific Divi module you miss, without dragging in a whole new builder.
- A search-and-replace plugin helps hunt down leftover Divi shortcodes and stale asset URLs across the database after you switch away.
- A staging environment from your host is the single biggest help — rebuild, switch off Divi, and test before any of it goes live.
- The SEO plugin you already run (Yoast or Rank Math) keeps titles and descriptions intact as long as you don't change slugs.
Most of the shortcode cleanup is genuinely manual. Once Divi is no longer rendering, you'll find pages littered with [et_pb_section] and similar shortcode fragments, plus gaps where a module used to be, and you fix those by hand or with careful search-and-replace. No plugin does it perfectly, so budget the time honestly.
On hosting: managed hosts like Cloudways bundle one-click staging and automated backups, which is exactly the workflow this migration needs. You clone to staging, rebuild and switch off Divi there, confirm every page renders in native blocks, then push live — turning a risky switch into a calm one.
07Pitfalls: leftover shortcodes and lost styling
Two problems catch nearly every Divi move, and both are avoidable once you expect them. They appear the moment Divi stops rendering your pages, so trigger that on staging where the mess can't reach real visitors.
The first is leftover shortcodes. Any page you didn't fully rebuild shows raw Divi shortcode text once Divi isn't rendering it. The second is lost styling: spacing, colors, and fonts Divi applied globally disappear, because that styling lived in Divi's settings, not in a clean theme.
Catch these before they go live
- Walk every page after switching off Divi on staging — any visible shortcode text marks a page you didn't finish rebuilding.
- Re-apply global styling in a block theme or its settings, since Divi's global colors, fonts, and spacing won't follow.
- Check mobile carefully. Divi handled responsive settings its own way, so your block layouts need their own mobile review.
- Don't delete Divi until you're sure. Switch away and confirm everything renders first, then remove it — keep it as a fallback while you finish.
Clear these on the staging copy and the live switch becomes a non-event. A page that looks right on staging with Divi switched off is a page that's genuinely free of it — that's the finish line for each one.
08FAQ
Is there a one-click way to convert Divi to Gutenberg?
No reliable one. Divi stores layouts in its own shortcode format that doesn't map onto native blocks, so converters at best lift plain text and some images. Plan to rebuild each page section by section in the block editor, and treat any conversion tool as a partial head start rather than a finished job.
Will moving from Divi to Gutenberg hurt my SEO?
Not if you keep URLs and headings the same. You're staying on WordPress, so slugs needn't change — and if they don't, there's nothing for Google to drop. Preserve the heading structure, leave your SEO plugin's titles untouched, and most sites see no ranking change beyond a usually-faster page.
What happens to my pages if I just switch off Divi?
Any page built in Divi breaks into raw shortcode text, because the layout only renders while Divi is active. That's exactly why you rebuild each page in blocks first and switch away from Divi only once every page already has a native version ready to take over.
Do I need to know any code to do this?
No. The rebuild is dragging native blocks into place in the editor, and the cleanup is checking pages and using a search-and-replace plugin. It's clicking and editing in a browser, not programming. If it still feels like too much, a managed host's support can handle the technical parts of the setup.
This is general, experience-based editorial guidance from running a theme shop, not financial or professional advice for your specific site. Verify plugin behavior and hosting features with the vendors and tools directly, and on a site carrying real revenue, treat that as the signal to test thoroughly on staging or bring in a professional.


