Troubleshooting
The problems we see most, and the fix for each.
Most PixMapr problems come down to one of the situations below.
The drawing editor misbehaves in the admin
Another plugin’s script can interfere with the hotspot editor. On the image edit screens, PixMapr shows a Script conflict protection notice: click Disable third-party scripts and other plugins’ scripts stop loading on those screens only. A green notice confirms it is on, with a one-click Re-enable third-party scripts to undo it. The rest of your admin and your site are never touched.
The image is blank inside a tab or accordion
An image hidden when the page loads has no size to measure. Call window.PixMapr.init() when the tab or panel becomes visible; the JavaScript API page has the snippet.
The image at the top of my page appears late
Lazy loading defers images until they are near the viewport, which is wrong for an image above the fold. Turn it off for that placement with lazy="no", or globally under Settings → Performance.
The image looks blurry
A small served size is being scaled up. Raise the image size to serve under Settings → Performance, or per placement with size="large". Hotspots stay aligned at any served size.
The shortcode shows the wrong image
Without an id, the shortcode shows the most recent interactive image. Set id to the image you mean; the ID is on the images list.
Interactive image pages show up in search results
By default they do not: image pages stay out of site search, the sitemap, and search engine indexes. If yours are indexed, the Findable on their own toggle under Settings → General has been switched on.
Edits do not show on the site
PixMapr’s own output cache refreshes itself on every edit, so a stale page usually comes from a page-level cache. Purge your caching plugin or CDN for that page.
The admin only shows the license screen
The license is missing, expired, or was deactivated. Activate a key under PixMapr → Settings → License; the License page covers moving a key between sites and freeing a seat.
Still stuck? Open a support ticket and include your WordPress and PHP versions and, when the problem is on a page, a link to it.