WordPress Customizer Changes Not Saving or Preview Stays Blank
The Customizer relies on JavaScript and the preview frame. Conflicts show as a blank or endless loading preview.
Reference guide. This guide is written from established practice and the official documentation of the tools involved. We have not yet tested every step on a live demo site. Back up your site before you change anything.
Fixes to try
- Look in the console for errors and failed requests. See reading the browser console.
- Disable plugins that modify the Customizer, then retest. See finding a plugin conflict.
- If the preview is blank, the site URL or https setting may differ between the admin and the front end.
- X-Frame-Options or CSP rules can block the preview frame. See Embedded Page Shows 'Refused to Display in a Frame' (X-Frame-Options / CSP).
- Raise PHP max_input_vars if a theme with many options will not save. See PHP settings.
- Try another browser.
If the theme has its own options panel, check its documentation for a reset option.
Related guides
- WordPress Theme Customizer Preview Blank or Stuck Loading
- WordPress Multilingual Plugins: URLs, Duplicates and SEO Issues
- WordPress Block Editor Fonts and Icons Missing in Editor But Fine on Site
- WordPress Background Images Not Loading on Mobile
Did this solve it? If not, email hello@sitefixlab.org with the exact error text and we will look into it. Try the problem finder.