Early Black Friday: Divi Doctor Lifetime for $129 (unlimited sites). Ends Cyber Monday. 14-day money-back guarantee.

Divi Doctor

Divi Doctor helps you find out why a Divi 5 site misbehaves, and adds a few things Divi can’t do yet. This page covers what you need, how to install the plugin, where everything is in the admin menu, and how to switch on your first feature.

Note: Divi Doctor comes in two plugins that share their settings: the free Doctor for Divi (coming to the WordPress.org plugin directory), and Divi Doctor Pro, which has everything on these pages. Screens and features that only Pro has are marked Pro in the free plugin. See Doctor for Divi (free) and Divi Doctor Pro.

A quick tour of the Divi Doctor menu, from the Overview to switching on a feature (about 1 minute).

What Divi Doctor does

Divi Doctor does three kinds of work, and each screen tells you which kind it is:

  • Diagnostics. Checks of your server, database, Divi’s CSS cache, Theme Builder layouts and update settings. Every check shows a verdict, the value it measured and the reason behind the verdict. These screens only read and report.
  • Bug fixes. Workarounds for long-standing Divi bugs. Each one is off until you switch it on.
  • Features Divi is missing. Extra options for the Contact Form, Email Optin, Image, Gallery, Portfolio, Blog, Video, Text and Number Counter modules, for backgrounds, and history for the Theme Builder and the Divi Library. Each one is off until you switch it on.

Fixes and features never edit Divi’s files. They hook into Divi while the page runs, so turning one off, or deactivating Divi Doctor, gives you stock Divi back straight away. Two actions change data Divi has saved, and only when you click them: restoring a revision in Layout History, and Remove Klaviyo accounts on the Klaviyo feature card.

Requirements

  • WordPress 6.4 or later
  • PHP 7.4 or later
  • The Divi 5 theme, version 5.15 or later. Bug fixes and features are built for the Divi 5 builder. With Divi 4 or another theme they are not supported and most have no effect. Many diagnostics still run on Divi 4, but the Divi 5 checks are skipped.
  • An Administrator account. The Divi Doctor screens need the manage_options capability.

Install Divi Doctor

These steps install Divi Doctor Pro. The free plugin, Doctor for Divi, is coming to the WordPress.org plugin directory. Once it is listed, go to Plugins, add a plugin, search for Doctor for Divi and click Install Now, then Activate. If the free plugin is already active, you can leave it active while you install Pro: it switches itself off, and your settings stay.

  1. Log in to your YemLogic dashboard and download the Divi Doctor .zip file. Leave it zipped.
  2. In your WordPress admin, go to Plugins, click the button at the top that adds a plugin (its name depends on your WordPress version), then Upload Plugin.
  3. Select the Divi Doctor .zip file and click Install Now.
  4. Click Activate Plugin.

A Divi Doctor menu with a heart icon appears in the admin sidebar, and a Divi Doctor item appears in the admin bar. Activation creates Divi Doctor’s own tables for its error log and snapshots, and sets every fix and feature to off. Nothing on your site changes until you switch something on.

Updating: when a new version is out, download it from your YemLogic dashboard and upload it the same way. WordPress offers to replace the installed version and keeps your settings and data.

After activation, Divi Doctor appears in the admin menu.

Each item in the menu is a section. Sections with more than one view have tabs along the top.

SectionTabsWhat it’s for
OverviewNoneStatus cards for each section and the most likely issues, ranked.
DiagnosticsSite Checks, Page Scan, Legacy Modules, Exception Watch, Hosting & ResourcesFind the cause of a problem. See Site checks, Exception Watch and hosting, Page Scan and Legacy Modules.
Safe ModeNoneChoose what Divi’s Safe Mode switches off, and turn Safe Mode on and off. See Safe Mode controls.
PerformanceRequest Profiler, Site WeightFind what makes the site slow. See Request Profiler and Site Weight.
Bug FixesNoneOpt-in workarounds for Divi bugs. See Known bug fixes.
FeaturesNoneOpt-in features Divi is missing, grouped by module.
Form EntriesNoneSaved Contact Form submissions. Appears once Save form entries has been switched on, and stays after you switch it off. See Saved form entries.
Layout HistoryTheme Builder, Divi LibraryEarlier versions of your Theme Builder layouts and Divi Library items. Shown while Layout history (revisions) or Divi Library history (revisions) is on. See Theme Builder and Divi Library history.
MonitoringSnapshots, Cron SetupWatch the site over time. See Monitoring.
SettingsNoneSite-wide settings: Accordion and Toggle speed, and closing the open Accordion item, and what happens to Divi Doctor’s data when you delete the plugin.

On the front end, administrators also see a Legacy modules: N item in the toolbar on pages where Divi runs Divi 4 modules in backwards compatibility mode. Click it to see where they are. See Legacy Modules.

Read-only, opt-in and stored-data labels

The top of every screen shows the section name, a one-line description and a label that says what the section can do:

  • Read-only: the screen inspects and reports, and changes nothing on the site. Overview, Diagnostics, Performance and Monitoring carry this label.
  • Opt-in · changes site behaviour: the screen has switches that change how your site works, but only for the items you switch on. Bug Fixes, Features, Layout History and Settings carry this label.
  • Stored by Divi Doctor: data Divi Doctor keeps on your site for a feature you switched on. Form Entries carries this label.

Read-only screens still have a few buttons, such as Clear log or Turn monitoring on. These only control Divi Doctor’s own tools and logs, never your content or Divi’s settings.

The Overview screen

Go to Divi Doctor → Overview. Five cards at the top show the live state of each section. Click a card to open its section.

  • Diagnostics: how many issues need a look, such as 5 to review, or No issues.
  • Performance: Recording, with the minutes left, or Idle.
  • Bug Fixes and Features: how many are switched on out of how many there are, such as 0 of 2 on.
  • Monitoring: On or Off.

Below the cards, Most likely issues, ranked lists up to eight checks that came back as Issue or Check, with the ones most likely to cause a visible problem first. It draws on the site checks, the hosting checks and the quick Site Weight checks. Treat each row as a lead to follow, not a final verdict. The Environment section at the bottom lists your Divi version, whether the Divi 5 builder engine is present, your child theme, and your WordPress and PHP versions.

Divi Doctor Overview screen with five status cards and a ranked list of issues, led by a constant that blocks automatic updates
The Overview: status cards for each section, then the most likely issues, ranked.
The Overview: status cards for each section and the most likely issues, ranked.

How to read a check

Every check is one row with a verdict badge, the name of the check, the value Divi Doctor measured and a short reason. Some rows also have a Suggested action.

  • Issue (red): likely to cause a problem. Start here.
  • Check (yellow): worth a look. It may or may not be what you’re seeing.
  • OK (green): the value is within a healthy range.
  • Info (gray): a fact about your site, with no verdict.

Turn on a feature

Go to Divi Doctor → Features. The top of the screen shows the Divi version Divi Doctor detected and whether the Divi 5 engine is present. If Divi 5 isn’t active, a notice says so. Features are grouped by the part of Divi they extend:

The site-wide Accordion and Toggle options are in Divi Doctor → Settings instead of Features: Accordion and Toggle speed, and closing the open Accordion item. The bug fixes are switched on in Divi Doctor → Bug Fixes.

To switch one on:

  1. Find the feature’s card. Its badge says Disabled.
  2. Open How it works on the card. It explains what the feature adds, where its options are in the Visual Builder, how to check it works and its limits.
  3. Click Enable. The page reloads and the badge says Enabled.
  4. Read the check rows under the card. They confirm that the parts of Divi the feature needs are present, for example Builder extension point showing available.
  5. Clear any page cache, then follow the card’s How to verify steps.

Most features add their options inside the Visual Builder, on the module they extend, and a page only uses them where you set them. To switch a feature off, click Disable on its card.

Divi Doctor Features screen showing the detected Divi version and the Mailchimp tags per form card, enabled, with OK check rows
Each feature card has its switch, a How it works panel and live checks.

Note: After a Divi update, send one test through each feature you use, such as a test message for the Contact Form features. Several feature cards show the Divi version they were built and checked against.

Turning on a feature (Image captions) and reading its How it works checks.

Next steps