Embeds overview
Model A — put Eventyvo features on your site without API keys; data stays in Eventyvo.
Embeds are the core of Model A: Eventyvo features on your website while operational data (registrations, payments, check-ins) remains in Eventyvo unless you add Model B.
Embeds load from https://docs.eventyvo.com. Visitors never send Connect API keys from the browser. Widget HTML is fetched via a read-only docs BFF.
Canonical host
Always use:
https://docs.eventyvo.com/embed/...
https://docs.eventyvo.com/embed/v1/eventyvo-embed.js
Do not document or copy www.eventyvo.com/embed/... for Connect widgets.
Widget types
| Widget | data-eventyvo | Route | Typical height |
|---|---|---|---|
| Event card | event-card | /embed/event/[slug] | ~360px |
| Agenda | agenda | /embed/agenda/[slug] | ~360px |
| Registration CTA | register | /embed/register/[slug] | ~80px (button only) |
| Catalog | catalog | /embed/catalog?companyId= | variable |
Script loader
<script async src="https://docs.eventyvo.com/embed/v1/eventyvo-embed.js"></script>
Mount any element with data-eventyvo after the script loads (or place the script at the end of body).
Common attributes
| Attribute | Widgets | Values |
|---|---|---|
data-eventyvo | all | event-card | agenda | register | catalog |
data-event-slug | card, agenda, register | Published event slug (required except catalog) |
data-company-id | catalog | Numeric company id |
data-theme | card, agenda | light (default) | dark |
data-lang | agenda | e.g. en, fr, ar (when agenda content supports it) |
Builder
Signed-in organizers: Embed builder — pick events and copy snippets.
Requirements & failure modes
| Symptom | Likely cause |
|---|---|
| Empty box | Missing data-event-slug, unpublished event, or wrong slug |
| CTA only, no form | By design — register embed is a button; see Registration CTA |
| Blocked in console | CSP — CSP, iframes & CORS |
| Test watermark | Event in TEST mode — Sandbox |
Full site instead of embeds
For a multi-page branded event website, use Subwebsite & custom domain — still Model A.
Need Eventyvo data in your CRM / doors?
Embeds do not give your servers attendee lists. Add Model B — Connect REST + webhooks — see Two website models.