Troubleshooting
The builder won't load or the page looks broken
A builder stuck on "Loading the builder…", an empty canvas, or an unstyled site usually comes from an optimization or security plugin changing scripts, a server rule, or a plugin conflict. Here's how to find it.
The builder doesn't open
"Loading the builder…" never goes away, or the page area stays empty
- Reload with Ctrl+Shift+R (⌘+Shift+R on a Mac).
- Try another browser, or turn off browser extensions such as ad blockers for your site.
- Pause JavaScript optimization in your caching or speed plugin: "defer", "delay", "combine" or "minify JavaScript", lazy-loading scripts, and LiteSpeed's Guest mode. These rewrite scripts in ways that break the builder and conflict with Kufi's Content Security Policy.
- Pause security plugins that block requests to the WordPress REST API, or allow logged-in users. The builder saves and draws the page through it.
- Deactivate other plugins one by one to find a conflict. Plugins that add their own page builder or "maintenance mode" are common causes.
"You can't change this page" means your user role isn't allowed to edit that page. Ask an administrator.
"The builder needs JavaScript" means JavaScript is turned off in your browser.
The site looks unstyled for visitors
- Pretty asset paths: if you turned on Kufi → Settings → Serve theme assets from /assets/ without adding the server rule, styles and scripts can't load. Turn it off, or add the rule from Security settings.
- CSS optimization: "Remove unused CSS", "Critical CSS" and "combine CSS" options can drop styles Kufi needs. Turn them off and purge the cache.
- Old cached files after an update: purge every cache, including your CDN.
Menus, sliders or popups don't react for visitors
Usually a JavaScript optimization option (defer, delay, combine) or a blocked script. Open the page in a private window, open the console (F12 → Console) and look for red errors. "Refused to execute" means the Content Security Policy is blocking a script; other errors usually name the plugin's file.
Safe settings for caching plugins
Keep page caching and minify on; they're safe. Turn off:
- JavaScript defer, delay and combine
- Guest mode or "optimize for guests"
- Remove unused CSS and critical CSS generation
- Lazy-loading of iframes and scripts (Kufi already loads videos and maps on click and images lazily)
Ask for help
Contact support with your site address, what you see, any red console errors, and the list of active plugins (Plugins screen or Tools → Site Health → Info).
More in Troubleshooting
Still need help?
Tell us what you are trying to do and what you see. We read every message.