Widget Not Appearing
The button doesn't show up on your site.
Work through these in order:
Check the browser console
Open DevTools and look for JavaScript errors around the SnagRelay script tag — a typo in the API key or a Content Security Policy block are the most common causes.
Confirm the script is loading
In the Network tab, check that a request to
app.snagrelay.com/widget/load/YOUR_API_KEY returns a 200 response. A 404 usually means
the API key is wrong or the Project was deleted; a CSP or ad-blocker issue will show the
request blocked entirely.
Check your API key
Compare the key in your snippet against the one shown on the Install Code tab — make sure it wasn't truncated or regenerated.
Check for CSS conflicts
The widget button is fixed-positioned; an aggressive global CSS rule (e.g.
* { z-index: 0 !important; }) can occasionally hide it behind other elements.
WordPress-specific: check visibility rules
If you're using the WordPress plugin, confirm the frontend/admin toggle and visibility rules (all visitors / logged-in / specific roles) match who you're testing as, and clear any WordPress or CDN cache after changing settings.
Screenshots fail, but the button shows up
That's usually a Basic Auth issue — if your site (or staging environment) requires HTTP authentication, enable Screenshot Authentication on the Install Code tab with the right credentials.