Troubleshooting: Cloudflare zone dropdown is blank or frozen in Super Page Cache
After clicking Connect to Cloudflare with a new or updated API token in Super Page Cache, the zone/domain dropdown may stay blank, fail to load, or cause the settings screen to freeze. This is usually a temporary UI state that a page refresh resolves.
Why this happens
When you connect or reconnect a Cloudflare API token, the plugin fetches your zone list from the Cloudflare API. If the response arrives before the page is fully ready, the dropdown can appear empty or the page can freeze with a browser-console error such as Cannot convert undefined or null to object. Refreshing the page after the connection is established lets the plugin load the zone list correctly.
Recovery steps
- After clicking Connect to Cloudflare, wait a moment, then refresh the browser page or navigate back to Settings → Super Page Cache → Cloudflare Integration.
- If the zone list still does not appear, clear your browser cache or perform a hard-refresh (Ctrl+Shift+R on Windows/Linux, Cmd+Shift+R on Mac), then reload the page.
- If the dropdown remains empty, re-enter your API token and click Connect to Cloudflare again, then select your zone.
- Confirm your API token includes all required Cloudflare permissions — especially zone-listing access, plus Cache Rules and Transform Rules where required. See the Cloudflare Permissions guide for the full list.
- If the selector still fails to load, contact support and include a screenshot of the Cloudflare Integration tab. If you see a browser-console error such as
Cannot convert undefined or null to object, include that in your message as well.
📝 Note: A blank zone dropdown immediately after token authentication is usually temporary. Refreshing the settings page is often enough to resolve it.
