Documentation / CMS widget

Install and embed the widget

The widget audits drafts in your CMS, then shows citation insights after publishing.

1. Add the script

<script src="https://cdn.helm.example/helm-geo-widget.js"></script>

2. Place the element

Set content-selector to the element that holds the authored content.

<helm-geo-widget
  api-base="https://api.helm.example/v1"
  content-selector="#editor"
  session-token="{{ token }}">
</helm-geo-widget>

3. Mint a session token

Your CMS server calls POST /v1/widget/sessions. The token is page-scoped and expires after five minutes.

4. Events and methods

The widget emits helm:* events and exposes open, close, runAudit and runCitations. Set api-base="mock" to try it without a backend.

Last updated 26 October 2026