> For the complete documentation index, see [llms.txt](https://docs.supademo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.supademo.com/troubleshooting.md).

# Troubleshooting

Fixes for the most common Supademo issues: embeds not loading, extension capture failures, silent recordings, playback problems, and SSO sign-in errors.

Fixes for the most common Supademo issues, organized by symptom. Each guide below starts with the most likely cause and works down the list, so you can usually resolve the problem in the first one or two steps without waiting on support. The guides cover the five areas that generate the most questions: embeds, extension capture, recording audio, demo playback, and SSO sign-in.

Before diving into a specific guide, two quick checks resolve a surprising share of issues:

1. **Test in an incognito window with extensions disabled.** Ad blockers and privacy extensions are the most common cause of demos or embeds behaving strangely.
2. **Open the demo's direct share link.** If the share link works but the embedded version doesn't, the problem is in the embed context, not the demo itself.

## Find your issue

| What you're seeing                                                | Start here                                                                                          |
| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| An embedded demo shows a blank or broken frame                    | [Embedded demo not loading](https://docs.supademo.com/troubleshooting/embed-not-loading)            |
| The Chrome extension isn't capturing screenshots or clicks        | [Chrome extension not capturing](https://docs.supademo.com/troubleshooting/extension-not-capturing) |
| A screen recording plays back with no audio                       | [Screen recording has no audio](https://docs.supademo.com/troubleshooting/recording-no-audio)       |
| A demo won't advance, hotspots don't respond, or playback is slow | [Demo playback issues](https://docs.supademo.com/troubleshooting/demo-playback-issues)              |
| You can't sign in with SSO, or an SSO-gated demo won't open       | [SSO login issues](https://docs.supademo.com/troubleshooting/sso-login-issues)                      |
| Still stuck, or your issue isn't listed                           | Email <support@supademo.com> or browse the [FAQs](https://docs.supademo.com/welcome/faqs)           |

## Contacting support

If a guide doesn't resolve your issue, email [**support@supademo.com**](mailto:support@supademo.com). You'll get the fastest resolution if you include:

* A link to the affected Supademo (and the page where it's embedded, if relevant)
* What you expected to happen and what happened instead
* Your browser and operating system, and whether the issue reproduces in an incognito window

The demo link is the single biggest time-saver: with it, the team can reproduce most issues on the first try.

For questions about how Supademo works rather than something that's broken — plans, features, limits — the FAQs and [Billing FAQ](https://docs.supademo.com/workspace-management/billing-and-payments/billing-faq) are the fastest place to look.