Web app widget troubleshooting

Widget not detected after installation

After installing the snippet, Huddlekit checks whether the widget is active on your site. You can see the result in the Install the widget window: open the ... menu on the project card and choose Install code. If it is still waiting for verification:

• Check the snippet is on the right page — it needs to be on the page you actually open, not just your homepage. To collect feedback across your whole site, add it somewhere that loads on every page — most site builders have a footer or site-wide code area for this.
• Check the address matches your project — the widget only loads on the address you entered when you created the project, so make sure you are visiting the same site, including https versus http and the exact subdomain.
• Open the live site — the check only passes when you open the real site where the snippet is installed. A local or staging copy will not count.
• Use Check verification — after opening your site, come back and select the Check verification button in the Install the widget window.

Widget not visible on the site

• The page was not opened with ?huddlekit — this is the most common cause. The widget stays hidden from ordinary visitors. Add ?huddlekit to the address (for example yoursite.com/pricing?huddlekit), or use the link from the project's Share or Install code window, which already includes it. Signed-in workspace members see it without the parameter once they have signed in.
• Guest access may be off — if Guest access to the widget is off in the project's Share window, guests are asked to sign in instead of seeing the widget. Only workspace members can use it. Open the ... menu on the project card, choose Share, and turn it on if guests should comment.
• The project may be archived — an archived web app project keeps its widget inactive. Open the Archive page in the sidebar and choose Restore from the project's ... menu.
• The snippet may be incomplete — make sure you copied the whole snippet and that your change is saved and published on the live page.

Comments not appearing where expected

Comments in web app projects are linked to the exact URL path where they were created. A comment left on /dashboard is not pinned when you are on /settings. The comments sidebar (M) still lists comments from every page, grouped by path, so you can find it there.

Widget overlaps site content

If the floating button is covering part of your site, press F on your keyboard to hide it (this switches to a fullscreen view). Press F again to bring it back.

Still having issues?

If the above steps do not resolve your problem, email support@huddlekit.com with your project key and a description of the issue.