---
url: https://docs.comnto.com/troubleshooting.md
description: >-
  Fixes for a widget that won't load (invalid site id, untrusted domain, CSP),
  wrong background colours, and overrides that don't apply.
---

# 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](/#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.