Skip to content
New

Announcement placeholder — product sites pass real copy via the announcement prop.

Learn more →

Widget isn’t showing at all

Six causes, in the order they are worth checking. Most cases are the first three.

Work through these in order

If the widget is missing on every device and every browser, it is one of six things. They are ordered by how often they turn out to be the cause, so start at the top rather than picking the interesting one.

  • Is the code actually on the page? View the page source and search for the widget code. If it is not there, it was pasted into a template that is not used by this page, or into a preview that was never published.

  • Is the code commented out? Some builders wrap pasted code in comments automatically. In the source, look for the snippet sitting inside <!-- -->.

  • Has the view limit been reached? Open the browser console. APP_VIEWS_LIMIT_REACHED means the widget stopped serving for the month. Your dashboard shows current usage.

  • Is the widget hidden or deleted? WIDGET_NOT_FOUND in the console means the widget was hidden from the dashboard or removed entirely.

  • Is a content security policy blocking it? A console message beginning *Refused to load the script because it violates the following Content Security Policy directive* means your site is blocking our domain. How to fix that.

  • Is the page cached? Site and CDN caches serve the version from before you added the code. Purge the cache and hard-reload.

How to open the browser console

Three of the six checks above are answered by one console message, so it is worth the thirty seconds. On Windows press F12 or Ctrl+Shift+J. On a Mac press Cmd+Option+J. Select the Console tab and reload the page.

You are looking for red text mentioning the widget or a security policy. If there is nothing red, the problem is upstream — the code is not on the page.

It shows in the editor but not on the live site

A different problem with a simpler cause. Changes made in the widget editor need publishing, and the Publish button greys out once there is nothing left to publish.

If it is greyed out and the live site still looks wrong, your website’s own cache is serving an old copy. Purge it, or wait an hour for most hosts to do it themselves.

It shows on desktop but not on mobile, or only on some pages

That is a setting rather than a fault. Floating layouts have display rules — which pages to appear on, which to hide on, and whether to show on desktop, mobile or both. Display rules covers where to find them.

When to stop and ask

If all six checks pass and it still does not appear, it is ours to look at. Send a direct link to the page where the widget should be, and the widget installation code. Without the link there is nothing to inspect, and that is the most common reason a support ticket takes a day longer than it needed to.

Questions

Other common problems