Simple Commenter Logo

Widget Configuration

Customize how the SimpleCommenter widget loads on your website using supported embed attributes.

Supported Embed Attributes

Use data attributes to tell the widget which project to load:

<script
  src="https://simplecommenter.com/js/comments.min.js"
  data-id="your-public-key"
  defer
></script>

The script tag identifies the project. Theme settings such as color and widget placement are loaded from the project's saved dashboard theme. Script attributes do not override saved theme settings.

Available Attributes

  • Name
    data-id
    Type
    string
    Description

    Your project's public key. This is the preferred identifier for new embeds.

  • Name
    data-domain
    Type
    string
    Description

    Your registered domain. This remains supported as a legacy fallback if you are not using a public key.

Theme and Position Precedence

SimpleCommenter resolves configuration in two layers:

  1. The embed script identifies the project with data-id or data-domain.
  2. The widget then loads theme settings, including color and position, from the project's saved dashboard configuration.

If you need to move the widget or change its colors, update the project under Theme Configuration in the dashboard.

Runtime Behavior

The current embed script is intentionally lightweight:

  • It identifies which project should load.
  • It pulls saved theme and access settings from the dashboard.
  • It renders the widget using that saved project configuration.

There is currently no public browser API for opening, closing, toggling, pre-filling user data, or subscribing to widget events from window.SimpleCommenter.

If you need to control who can access the widget or when it appears, use Access Settings. If you need to change colors or placement, use Theme Configuration.

Next Steps

Was this page helpful?