Troubleshooting & FAQ for Panels

The form field renders but the preview canvas is missing, or the page layout looks broken

First check whether WordPress debug display is on. On a production site, WP_DEBUG_DISPLAY should be off — a PHP notice printed into the page (from any plugin or theme) can break the surrounding markup and make the preview disappear. Panels itself is clean on current versions, but debug display on a live site turns any stray notice from anywhere into a layout problem. Keep debug logging on if you like; keep debug *display* off in production.

I updated Panels but don't see the new behavior

Confirm what's actually running, in this order:

  1. Plugins screen — does the Panels version number match the version you installed?

  2. Hard-refresh the page (Ctrl/Cmd-Shift-R). Panels versions its scripts, so browsers fetch fresh files on a real update — but an aggressive page cache or CDN can serve stale HTML. Purge caches if the version query string on Panels' script URLs (view the page source and look for ?ver=) doesn't match the plugin version.

  3. If you deploy by copying files, make sure you copied to the site that's actually serving — a staging/production or sync mismatch shows exactly these symptoms.

The browser console shows a 404 for a .map file

Harmless. Source-map files are developer conveniences the browser asks for when its dev tools are open; the missing file has no effect on visitors.

A visitor's uploaded photo doesn't appear in their image

Panels only renders uploads that pass its safety checks: the file must be a real PNG, JPEG, or WebP (checked by content, not just extension), must still exist on the server, and must live in your site's own uploads area. SVG files are always rejected. If a legitimate photo is skipped, re-save it as JPEG or PNG and upload again.

Translation says "temporarily unavailable"

The translation service call failed — most commonly an invalid or exhausted DeepL key, or a network issue. Go to Panels → Settings → Translation and use Test Connection; it reports key validity and remaining quota. (Detailed error text is intentionally shown only on debug-enabled sites.)

A guest says their download or translation "session expired"

Guest sessions are deliberately short: 10 minutes, single-use, for security. The visitor just submits the form again.

Does Panels work with my page builder?

Yes. Panels is page-builder-agnostic — it renders wherever a Gravity Forms form renders: Divi, Elementor, the block editor, classic themes. Both AJAX and non-AJAX form embeds are supported.

Are visitor uploads safe? What about privacy?

Uploaded images are verified by their actual content, rebuilt pixel-by-pixel before use, and stripped of hidden metadata — including GPS location from phone photos. SVG uploads are rejected outright. Only visitors who explicitly opt in have their text sent for translation, over an encrypted connection.

Where did a generated image go?

Generated images are kept 90 days by default, then cleaned up (your developer can lengthen or shorten this). Images a visitor never finished generating are cleaned up sooner, per the orphan-retention setting.