Skip to main content

Minify troubleshooting

Symptom​

After enabling CSS or JavaScript minification/combination, parts of the site break: missing styles, console errors, non-working menus, filters, forms, or builder-related scripts.

Applies To​

Likely Causes​

  1. A script or stylesheet that must load unminified is in a queue.
  2. Combine order breaks a dependency (for example jQuery plugins).
  3. Another plugin is also minifying the same files.
  4. Divi Engine or Divi core handles were forced into a public minify queue.

Fix​

Step 1: Confirm minify is the cause​

  1. Disable script minification and style minification in Divi Engine → Nitro Settings → Scripts & CSS (or use Debug Tools to disable all features).
  2. Clear minify cache and hard-refresh logged out.
  3. If the site recovers, continue below.

Step 2: Use Smart Minify suggestions and the Frontend Asset Helper​

  1. Enable the Frontend Asset Helper (admin bar) from Nitro minify settings.
  2. View the homepage logged in with the helper.
  3. Prefer Smart Minify suggestions / safe queues instead of pasting every handle.
  4. Leave Divi Engine and protected Divi items out of public queues (Nitro already prefers this by default).

Step 3: Isolate JavaScript queues​

  1. Clear the JS minify queue (or start from suggestions only).
  2. Re-add scripts in small groups, save, clear minify cache, and test.
  3. When something breaks, move the last added handle to a separate queue or remove it.
  4. Try removing or splitting divi-custom-script and et-common-core first if those appear in your list — they are common troublemakers.

Step 4: Isolate CSS queues​

  1. Same process for CSS: small batches, clear cache, test.
  2. Try child-theme and parent-theme styles first if the layout breaks.

Step 5: Avoid double minification​

Turn off minify/combine in LiteSpeed, WP Rocket, or WP-Optimize if Nitro is minifying — or the reverse. Do not run both.

Verify​

Front-end pages look correct logged out, and the browser console has no minify-related script errors. Filters, forms, and menus still work.

Collect for Support​

  • Which handle or queue entry fixed the issue when removed
  • Whether JS, CSS, or both were enabled
  • Other minify plugins active
  • Console error text

What's Next​