Notion <> Code: Document narration playback, languages, eligibility

[mintlify]

Summary

Expands the narration page with playback, language, and eligibility details from the Narration & Voice Conversation spec, checked against the shipped code.

Changes

• Adds Playback controls: the estimated duration switches to the exact duration after the first generation, and the speed button cycles 1.0x → 1.2x → 1.5x → 2.0x → 0.8x.
• Adds Languages: narration follows the page's language division and falls back to English.
• Adds Which pages you can narrate: the 10-word minimum (40 characters for languages without spaces between words), the 40,000-character maximum, and exclusions for auth, personalization, BYOK, and preview deployments.
• Notes that variables are replaced before narration, and explains how to disable narration.

Context

Voice conversation from the spec has not shipped in code yet, so this PR doesn't document it.

---

Note

Low Risk
Documentation-only updates with no runtime or configuration changes in this repo.

Overview
Expands assistant/narration.mdx so narration behavior matches the shipped product spec: eligibility is moved into a dedicated Which pages you can narrate section (10-word / 40-character minimums, 40k-character cap, non-prose limits, and blocks for auth, personalization, BYOK, preview deployments, and hidden dashboard settings).

Adds Playback controls (estimated vs exact duration, speed cycle 1.0x → 1.2x → 1.5x → 2.0x → 0.8x), Languages (language division with English fallback), variable substitution before TTS, and steps to disable Page narration.

^{Reviewed by Cursor Bugbot for commit 5ca1a9f. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
mintlify	🟢 Ready	View Preview	Sep 29, 2026, 4:54 PM