Docs Demo Dashboard Get your key
On this page
  1. Making a key
  2. What a key does
  3. One domain, with its subdomains
  4. Addresses that never count
  5. Keys and your plan
  6. Revoking and regenerating

Embed keys and domains

An embed key is a string starting with sl_embed_ that says which site the script is on. A key works on one domain and all of its subdomains.

Making a key

Keys are made under API Key in the dashboard, where you can give each a label such as the site it is for. The key goes in the script tag as data-key; see Install the script.

The key is meant to be public: it ships in your HTML, and it grants nothing by itself. Reading and writing comments still happens as the visitor's own session, under the database's row-level security.

What a key does

On every page load the script sends the key and the page's hostname to SharedLayers and gets back the site it stands for, whether the account may embed, and whether this hostname is allowed. Only then does it draw anything. A key that fails this check makes the script log one warning and stop. The check cannot be skipped from the page: without it the script has no site to show comments for.

One domain, with its subdomains

There is nothing to set up. The first time the script loads with a new key, the key takes that page's domain, and from then on it works there and on every subdomain of it. The key's card in the dashboard says which: On acme.com.

Addresses that never count

These work with any key and never become its domain:

Keys and your plan

Installing by script is part of the Pro plan, and how many domains your account can have comments on is set by the plan: Pro comes in blocks of five, under Plan in the dashboard. Make one key per site: it is what lets you revoke one site without touching the others.

Keys made before 23 October 2026 could take up to five domains. They keep those domains, and take a new one only once they have none left.

Revoking and regenerating

Revoking a key makes every snippet that carries it stop loading, immediately on the next page view. Comments are not deleted. Regenerating a key gives it a new string while keeping the same site and comments; update the snippet and the old string stops working.

A revoked key and a mistyped key look the same to the script, and both produce the “not recognised” warning listed under Console messages.