Embedding the live player on your Builder site
Drop a Live Stream block on any page of your Builder site and the broadcast plays inline — viewers never leave your domain. This is the difference between "watch us on YouTube" and "watch us right here." It matters for trust, SEO, and brand.
How to add the block:
1. **Open your site in Builder** — pick the page where the live stream should live. A church might add it to the home page; a community center to a dedicated /live page; a conference site to the keynote schedule page.
2. **+ Add block → Live Stream** — drop the block where you want it. The placeholder shows "Live Stream block — pick a broadcast to embed."
3. **Configure the block** — in the right panel, fill in:
- **Heading** (optional) — e.g. "Watch live" or "Sunday Service"
- **Subhead** (optional) — short description
- **Broadcast id or slug** — paste the broadcast's public viewer URL (`/live/b/<slug>`) OR just the slug. The block accepts either.
- **Background** — page / card / transparent
4. **Save the page** — the block is live the moment the page publishes.
What viewers see:
- When the broadcast is live: Turtini's built-in player with DVR rewind, a hover scrub-preview, catch-up-to-live, picture-in-picture, and any sponsor ad cards or production graphics the host fires — mobile-responsive.
- When the broadcast has ended AND you opted to publish the recording: the recording plays in the same spot (Cloudflare's recording player).
- When the broadcast hasn't started or has ended without a published recording: a clean "not live right now" panel. Page doesn't look broken between events.
Best practices:
- **One block per page**. The block resolves the broadcast by slug at render time, so picking the same slug on multiple pages is fine but slightly wastes attention.
- **Stable slug strategy** for recurring events. If you're streaming every Sunday, consider:
- Option A: create a fresh broadcast each week and update the block to the new slug each Saturday. Best for archived recordings (each week is its own URL).
- Option B: reuse one "Sunday Service Stream" broadcast across weeks. Recordings get overwritten when you go live again; URL stays the same.
- **Hero-section embed** works great. Make the Live Stream block the first thing visitors see during a known event window.
Builder export note: the Live Stream block is a runtime-only block. When you export your Builder site to GitHub for static hosting, the block emits a "View on live site" stub — the live HLS player requires runtime resolution of the broadcast state and can't be statically baked.