diff --git a/fern/docs.yml b/fern/docs.yml
index 61ad0be4..f9425f40 100644
--- a/fern/docs.yml
+++ b/fern/docs.yml
@@ -558,8 +558,12 @@ navigation:
- section: Voices (Text-to-speech)
icon: fa-light fa-waveform-lines
contents:
- - page: Vapi Voices
+ - section: Vapi Voices
path: providers/voice/vapi-voices.mdx
+ contents:
+ - page: Legacy migration
+ path: providers/voice/vapi-voices/legacy-migration.mdx
+ icon: fa-light fa-triangle-exclamation
- page: ElevenLabs
path: providers/voice/elevenlabs.mdx
- page: PlayHT
diff --git a/fern/providers/voice/vapi-voices.mdx b/fern/providers/voice/vapi-voices.mdx
index d377a732..b88b19cb 100644
--- a/fern/providers/voice/vapi-voices.mdx
+++ b/fern/providers/voice/vapi-voices.mdx
@@ -5,12 +5,12 @@ slug: providers/voice/vapi-voices
---
-**Legacy Voice Notice:** The following voices are being phased out: **Paige, Spencer, Neha, Harry, Cole, Hana, Lily, Kylie**
+**Legacy Voice Notice:** The following voices are being phased out and will be retired on **March 1, 2026**: **Spencer, Neha, Harry, Cole, Paige, Hana, Lily, Kylie, Rohan**
- Existing assistants using these voices may continue to use them during the transition period
- New assistants cannot be created using legacy voices
-- Legacy voices will be fully retired in a future update
+- After March 1, 2026, assistants using legacy voices will be automatically switched to a default replacement
-We recommend using one of the Active Voices listed below.
+We recommend using one of the Active Voices listed below. For migration details and replacement voice options, see our [Legacy voice migration guide](/providers/voice/vapi-voices/legacy-migration).
## What are Vapi Voices?
@@ -28,13 +28,6 @@ Vapi Voices is our carefully curated selection of high-quality voices designed t
These voices are fully supported and recommended for new assistants.
-### Rohan
-- **Gender**: Male
-- **Accent**: Indian American
-- **Age**: 24 years old
-- **Characteristics**: Bright, optimistic, cheerful, energetic
-- **Sample Audio**:
-
### Elliot
- **Gender**: Male
- **Accent**: Canadian
diff --git a/fern/providers/voice/vapi-voices/legacy-migration.mdx b/fern/providers/voice/vapi-voices/legacy-migration.mdx
new file mode 100644
index 00000000..13339927
--- /dev/null
+++ b/fern/providers/voice/vapi-voices/legacy-migration.mdx
@@ -0,0 +1,99 @@
+---
+title: Legacy voice migration
+subtitle: Migration guide for Vapi Voices being retired on March 1, 2026
+slug: providers/voice/vapi-voices/legacy-migration
+---
+
+
+ **Action Required:** The following legacy voices will be retired on **March 1, 2026**: Spencer, Neha, Harry, Cole, Paige, Hana, Lily, Kylie, and Rohan. Migrate your assistants before this date to maintain uninterrupted service.
+
+
+## Overview
+
+We're updating Vapi Voices to provide you with the best possible voice experience. As part of this update, we're phasing out nine legacy voices and replacing them with carefully selected alternatives that maintain similar tone and style characteristics.
+
+## Legacy voices being retired
+
+The following voices will be retired on **March 1, 2026**:
+
+- Spencer
+- Neha
+- Harry
+- Cole
+- Paige
+- Hana
+- Lily
+- Kylie
+- Rohan
+
+## What this means for you
+
+- **Existing assistants** using these voices will continue to work during the transition period
+- **New assistants** can no longer be created using legacy voices
+- **After March 1, 2026**, any assistants still using legacy voices will be automatically switched to the default replacement voice (Option 1 in the table below)
+
+## Replacement voice mapping
+
+We've selected replacement voices from the same providers (ElevenLabs/Cartesia) at the same pricing. These were chosen using ElevenLabs' voice matching tool to find the closest match in tone and style.
+
+
+ The replacement voice data will be populated soon. Check back for updates or contact support for assistance with voice selection.
+
+
+| Legacy Voice | Option 1 (Default) | Option 2 | Option 3 |
+|--------------|-------------------|----------|----------|
+| Spencer | TBD | TBD | TBD |
+| Neha | TBD | TBD | TBD |
+| Harry | TBD | TBD | TBD |
+| Cole | TBD | TBD | TBD |
+| Paige | TBD | TBD | TBD |
+| Hana | TBD | TBD | TBD |
+| Lily | TBD | TBD | TBD |
+| Kylie | TBD | TBD | TBD |
+| Rohan | TBD | TBD | TBD |
+
+## FAQ
+
+
+
+ We used ElevenLabs' voice matching tool to find the most appropriate replacements for each legacy voice based on tone, style, and characteristics. Replacements are from the same provider at the same pricing.
+
+
+
+ Any assistants still using legacy voices after March 1, 2026 will be automatically switched to the Option 1 (default fallback) voice shown in the table above.
+
+
+
+ No. Replacement voices were chosen at the same pricing tier as the legacy voices they replace.
+
+
+
+ You can switch your assistant's voice in two ways:
+
+ 1. **Dashboard:** Go to your assistant settings and select a new voice from the dropdown
+ 2. **API:** Update the `voiceId` field in your assistant configuration via the API
+
+
+
+ Yes. We provide three recommended options for each legacy voice, but you're free to choose any available voice that fits your needs. We encourage you to switch before March 1 so you can select the voice that works best for you.
+
+
+
+ Yes. Your account team will reach out with personalized support. If you have questions in the meantime, contact your FDE or AE directly.
+
+
+
+ Reach out to support@vapi.ai or contact your account team if you're an Enterprise customer.
+
+
+
+## Next steps
+
+
+
+ View our current selection of fully supported Vapi Voices
+
+
+ Explore ElevenLabs voices for more options
+
+