--- title: "Troubleshooting: the Beamer widget isn't appearing on my site" slug: "troubleshooting-the-beamer-widget-isnt-appearing-on-my-site" updated: 2026-08-14T18:11:24Z published: 2026-08-14T18:11:24Z canonical: "help.userflow.com/troubleshooting-the-beamer-widget-isnt-appearing-on-my-site" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.userflow.com/llms.txt > Use this file to discover all available pages before exploring further. # Troubleshooting: the Beamer widget isn't appearing on my site If the Beamer widget or button isn’t showing up where you installed it, work through these checks in order. Most cases come down to the snippet, the widget being switched off, the domain restriction, or how the widget is configured to display. ## 1. Confirm the embed snippet is installed correctly - Make sure the Beamer snippet is pasted inside the `<body>` of your page, near the bottom, and that your correct product ID is set in `beamer_config`. - The `beamer_config` object must be declared before the `beamer-embed.js` script loads. - Check your browser console for errors from Beamer on page load. ## 2. Make sure the Beamer widget is turned on Check that the widget is enabled under **Settings > Widget > Beamer widget**. If this toggle is switched off, the widget won’t load on your site (the initialization response returns `enabled: false`). Turn it on and reload. Turned it off but users still see it? Widget changes can take time to reach end users, because browsers cache the widget assets. A hard refresh confirms whether the change has actually applied. If it looks right on a hard refresh, your users will pick it up as their caches expire. ## 3. Check your domain restriction If you’ve set a Domain Restriction (**Settings > General**) or a domain whitelist, Beamer only loads on the domains you listed. Confirm the page’s domain (and subdomain) is included. If the field is blank, Beamer runs on any page with your snippet. See [How to use Domain Whitelist?](/beamer/docs/how-to-use-domain-whitelist) ## 4. Check how the widget is set to display - If you’re using a custom selector for the button, make sure that element exists on the page. - If `lazy: true` is set, Beamer won’t initialize until you call `Beamer.init()`. - You can force the feed open for testing by calling `Beamer.show()` in the browser console. ## 5. Confirm there’s something to show A brand-new account with no published posts may show an empty or hidden widget. Publish a post and reload. ## The widget opens but the feed is empty This is a different problem from the widget not appearing, and the checks above won’t find it. If the button renders, the panel opens on click, and the feed inside stays blank, the widget is working — what’s failing is the content reaching it. **Start with segmentation.** Nine times out of ten this is the answer. Open your most recent post and check whether it has a segment filter or a segment URL applied. A segmented post only reaches visitors who match it, so if your newest posts are segmented and the visitor doesn’t match, the feed is correctly empty for that visitor. Quick test: open the same page as a visitor who does match the segment, or clear the filter on one post temporarily and reload. If the post appears, segmentation was the cause. If segmentation isn’t it, check: - **The Changelog is switched on for this placement.** Go to **Settings > Widget > Buttons & Triggers**. There are separate switches for the widget and the standalone page, and the panel can still open with nothing in it if the relevant one is off. - **Your domain restriction.** If a Domain Restriction is set under **Settings > General** and this page’s domain isn’t listed, posts won’t be delivered here even though the widget renders. - **Your posts are published and unexpired.** An expiration date that has passed removes a post everywhere at once. ### If you’ve been through all of that Contact our support team with: - Whether the widget itself loads, or only the feed is empty. - Whether your most recent post has any segment filter or segment URL applied. - A Jam or Loom recording of what you’re seeing. A recording captures the console and network activity alongside the screen, which is usually what tells us what’s happening. ## Still not showing? Contact our support team with your site URL and a screenshot of your install, and we’ll help you track it down.