Skip to content
Lightning CMP

Configuration overview

Everything is configured through a single object passed to init():

lightning("init", {
  theme: "light",
  position: "bottom",
  // …every other option is optional
});

What you set vs. what’s supplied

Section titled “What you set vs. what’s supplied”
  • siteId is the only strictly required field — and the license key usually supplies it, so you rarely set it by hand.
  • Regulation is resolved at the edge from the visitor’s region unless you force it with geo.
  • Everything else has a sensible default (light theme, bottom banner, all categories, Consent Mode on, GPC honoured, floating button on).

Central config merges over inline

Section titled “Central config merges over inline”

You can manage settings centrally per-site in the dashboard. Dashboard config is merged over your init() object, so you can change copy, theming or categories without redeploying the page.

Where to go next

Section titled “Where to go next”