Customizer fails to open or shows a blank screen when trying to modify theme settings.
Theme Customizer Not Loading
Key Points: The WordPress Customizer hangs, loads endlessly, or shows a white screen.
You go to Appearance → Customize — and wait… and wait… nothing. It spins, flashes, or crashes. That’s your theme tripping over something inside the Customizer.
🧯 Common Triggers
- JS or PHP errors in theme’s
customizer.php - Conflicts with third-party plugins (especially visual builders)
- Theme uses deprecated Customizer controls
- Broken live preview hooks or missing callbacks
🛠️ Fixes
- Enable
WP_DEBUGto reveal any PHP errors - Deactivate all plugins and try again
- Switch to a default theme to test if the problem is theme-specific
- Use browser console to check JS issues
🔍 Insight
Some themes offload their settings to custom panels — try using their provided options panel if Customizer is blocked.