‹ Platforms
Web troubleshooting
Fix embed and in-tab rendering problems by symptom.
| Symptom | Cause | Fix |
|---|---|---|
| The microphone never activates | allow is missing microphone * | use allow="microphone *" |
The frame shows Agent not found | the agent code is wrong | copy the code from the agent’s Share Agent dialog |
With render=local, the frame says “This device can’t keep up with this avatar (reason). Try another device or browser.” | unsupported browser, no supported graphics path, or the device measured too slow | choose render=cloud for that visitor; see the device check |
With render=local, the frame says “This avatar can only be rendered in the cloud” | an Expression 1 model | remove render=local, or add model= with another model the agent supports |
With render=local, the frame says “This avatar can’t be rendered in the browser” | the avatar has no browser build | remove render=local |
With render=local, the frame says “In-browser rendering is turned off right now” | bitHuman has switched off in-tab rendering for this model | remove render=local |
| The iframe shows a browser error page | your page sends Cross-Origin-Embedder-Policy | remove that header from the page that holds the iframe |
| A blank frame | a service problem | check status.bithuman.ai, then reload |
Your own avatar shows Embedding is disabled for this agent | its Let anyone talk without signing in setting is off | turn it back on in the agent’s Share Agent dialog, or keep it off and pass an embed token (?token=) |