Skip to content

Integration

Prerequisites

Before integrating the widget, ensure you have an active Commentix account and subscription at commentix.com.

Register your website in the Commentix Console by selecting Add Site. Once the site is registered, you will be provided with a unique SITE_ID, which is required to embed the widget.

Embedding the Widget

Add the following snippet at the location in your HTML where the comment section should appear:

<script src="https://static.commentix.com/js/widget.js" defer></script>
<commentix-widget site="{{ SITE_ID }}"></commentix-widget>

Note

  • The script registers the <commentix-widget> custom element.
  • The defer attribute is recommended to avoid blocking page rendering.
  • The site attribute must be set to your registered SITE_ID.
  • The widget initializes automatically once the script has loaded.

Warning

Some setups require the thread attribute on the <commentix-widget> element to prevent problems. See the Configuration page for more information.

Layout and Responsiveness

The widget is fully responsive and expands to the full width of its parent container by default. For very wide layouts, applying a maximum width is recommended to maintain readability.

Excessive line length can negatively impact reading comfort. For optimal legibility, comment content should generally fall within 45 – 75 characters per line.

Example

commentix-widget {
    max-width: 800px;
}

Multilingual Websites

The widget supports over 20 languages. By default, it attempts to detect the site's language via the lang attribute of the <html> element. If the detected language is not supported, it falls back to English.

To force a specific locale, you can define the language attribute on the <commentix-widget> element. For an example and the complete list of supported language codes, refer to the language attribute in the Configuration section.

Terms and Privacy Disclosure

The Commentix widget itself does not automatically render links to the Commentix Terms and Conditions or Privacy Policy within the embedded UI.

Depending on your jurisdiction (for example, GDPR, UK GDPR, CCPA/CPRA, or similar data protection regulations), you may be legally required to disclose all third-party services that process user data on your website. As the site owner and data controller, you are responsible for ensuring that this disclosure is provided in an appropriate and accessible manner.