Build your widget
Help & support

Widget troubleshooting

Nearly every problem is one of the first three below. If yours isn’t, email us — a real person reads it.

The widget isn’t showing up at all.
Three causes account for nearly all of it. The script was stripped: many CMSs remove <script> tags from content written by non-administrators — paste it as an administrator, or use an HTML/Code/Embed block instead of the rich-text editor. An optimizer delayed it: WP Rocket’s “Delay JS”, Perfmatters, LiteSpeed and Cloudflare Rocket Loader all defer third-party scripts; the snippet carries data-cfasync="false", which they honour, so make sure it survived the paste. A Content-Security-Policy blocked it: if your site sends one, allow frame-src https://photerra.com and script-src https://photerra.com.
It shows “Couldn’t load spots”.
That means the frame loaded but the data request did not finish — almost always a network or corporate-proxy issue on the viewing device, not your site. Reload once. If it persists on more than one device, email us with the page URL: the widget reports its own failures to us, so we can usually see it from our side.
It’s showing the wrong city.
The location comes from the data-hub (or data-lat/data-lng) value in your embed. Rebuild the line in the widget builder with the right location and replace the whole line. If your area is not in the list yet, ask us — adding a location is something we do on request.
My city isn’t available.
We add locations deliberately rather than scraping the world, so coverage is real where it exists. Email info@photerra.com with the city or region and the site you want it on, and we will tell you honestly whether and when we can cover it.
The height is wrong, or it’s cut off.
The widget measures itself and tells the page how tall it is. If that message is blocked — Wix, for instance, gives every embed a fixed box — set the height yourself: roughly 560px for a two-row grid, 580px with the map, 320px for a strip, 480px for a sidebar rail, 190px for the badge.
Can I change the colors, fonts and layout?
Yes. The builder exposes location, layout (grid, strip, sidebar rail, badge), number of rows or photos, light/dark/auto theme, accent color, background, corner radius and font. The “Native” style is transparent and borderless so it sits directly on your own background.
Does it track my visitors?
No. The widget sets no cookies, writes nothing to storage, and creates no visitor identifier — so it needs no entry in your cookie banner. It does send us one message per embed load saying which domain it loaded on, which location was requested, whether it rendered and how many photos it showed. That is how we find out a customer’s embed is broken. It contains nothing about the visitor.
Who owns the photos, and do I need permission?
Photographers keep their copyright. Displaying the widget is covered by our Terms, and every photo carries its credit inside the widget — traveler photography names the contributor, and openly-licensed archive photography names the author, the licence and the source, with links. Do not remove or cover the credits: that is the one condition.
Can I use it on a commercial site?
Yes — hotels, vacation rentals, tour operators, restaurants, tourism boards and travel publishers are exactly who it is for. It is free and stays free for that use.
Will it help my SEO?
Honestly: not directly. The widget renders inside an iframe, so its content is not indexed as part of your page, and we would rather say so than let you find out later. What it does is give your visitors a reason to stay and explore the area — which is the thing that actually matters for a page about where you are.
How do I remove it?
Delete the one line you pasted. Nothing else is left behind: no plugin residue, no cookies, no stored data, no account.

Still stuck? Send us the URL of the page it should be on and a screenshot. That is almost always enough — we can reproduce most installs in a couple of minutes.

Install guides
← All the ways to use Photerra on your site