Troubleshooting

Something not working as expected? Start here.

Widget fails to load

• Console shows “Invalid site id” – confirm every comments container has data-site="your-site-id" or that you pass site: 'your-site-id' to window.comnto(), and make sure the site is active in Comnto.
• Console shows “Untrusted domain” – add the current hostname to the trusted domains list in the dashboard.
• Empty container – confirm the element carries data-comnto, includes the necessary attributes (especially data-site), and exists before the script executes.
• CSP blocks the iframe – allow the widget origin in your frame-src/child-src Content Security Policy.

Background colour looks wrong

• Ensure the container or ancestor actually changes background when your theme toggles. The widget reads computed styles while observing mutations.
• Provide colors.surface explicitly if your theme animation delays the background change.
• After a complex animation, call widget.update({ theme: 'auto' }) to force a recalculation.

Localization or colours do not update

• Check that your plan includes these customization features — the widget ignores overrides if they’re not supported by your plan.

Still stuck?

• Re-run the steps in Getting Started.
• Inspect network responses for the API endpoints used by the widget.
• Reach out to Comnto support with the site id, page URL, and any console logs.