Developer docs
Experiences
An experience is a change on the page the shopper is already on — aimed at a path, device, locale, country, or segment. Agents draft. A person publishes.
Mark regions
Preferred. Keys are [a-zA-Z0-9_-], up to 64 characters. Executen can also discover common regions (hero, banner, product cards) — discovery is imperfect. Selectors are validated. No javascript: schemes.
<h1 data-executen="hero-title">The oak table</h1>
<p data-executen="hero-sub">Made to last a generation.</p>
<a data-executen="hero-cta" href="/shop">Shop the collection</a>
<img data-executen="hero-image" src="/oak.jpg" alt="Oak table">What decide may do
| Action | Effect |
|---|---|
| set_text | textContent only. HTML is literal text, not a script host. |
| set_html_safe / replace_component | Sanitized HTML. |
| insert_component | Sanitized HTML, inserted. |
| set_image / set_link | URL scheme validated. |
| set_attribute | Allow-listed names. No on*, no style. |
| show / hide | display toggle. |
Targeting
- Page path.
- Optional segment membership.
- Optional country, device, locale.
- Country may be enriched from CDN headers on ingest. Telemetry, not authentication.
Draft → review → live → pause. Versions you can roll back. Preview uses a preview token and does not pollute live analytics. Publish from Action Center.
