Documentation Index
Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt
Use this file to discover all available pages before exploring further.
Voice Library is a dedicated page that lists every custom voice you have cloned or designed. The page subtitle reads Your cloned and designed voices live here. Use them from the Studio’s voice picker. Voices are private to your account, only you can see them.
Page anatomy
The page is one full-width column inside the dashboard.| Region | What you see |
|---|---|
| Header | Title Voice Library, the subtitle, and a small voice count line directly under it that reads voices (or 1 voice in the singular case). |
| Create A Voice button | A brand-gradient pill on the end edge of the header with a + icon. Opens the Create a new voice picker. |
| Voice grid | A responsive grid of voice cards (1, 2, or 3 columns depending on viewport). Empty when you have not made any voices yet. |
| Empty state | A dashed-border card centered on the page with a microphone icon, the heading No custom voices yet, the body Create your first custom voice by cloning from a sample or designing one from attributes., and a Create your first voice button. |
| Topbar (provided by the dashboard) | A second + Create Voice button. Clicking it opens the same picker as the header button. |
The voice card
Each card is split into a 16:9 cover area and a body.Cover area
| Element | Notes |
|---|---|
| Cover image | The image you uploaded when you cloned or designed the voice. The image is cropped to fill the cover. |
| Fallback tile | When you did not upload a cover, a 64 px round tile takes the cover space, showing the voice’s first letter. The tile color is generated deterministically from the voice id, so the same voice always shows the same tint. |
Body
| Element | What it says |
|---|---|
| Name | The name you gave the voice when you created it. |
| Status chip | Top-end-edge corner of the body. Ready (green), Training (amber), or Failed (red). |
| Source pill | A small rounded chip showing the source. Cloned with a microphone icon if you uploaded or recorded a sample. Designed with a magic-wand icon if you described one from attributes. |
| Language code | The macro language code from creation, in mono digits, left to right. |
| Dialect code | When set, the dialect code appears next to the language, separated by a middle dot. |
| Transcription preview | When the voice was cloned and the transcription was confirmed, the first two lines of that transcription appear below the chips. |
| Audio sample | When the voice has a saved sample, an inline browser audio player lets you scrub and play. |
| Delete action | The end edge of the card footer carries a small icon button with a trash icon and the label Delete. Hovering it tints to the destructive (red) color. |
Status pipeline
A voice you just created starts in Training. The card stays on the page while the engine processes the sample or attributes, and the chip flips to Ready when training succeeds, or Failed when it errored.| Chip | Meaning | What you can do |
|---|---|---|
| Ready | The voice is searchable in the Voice Picker and usable in Studio. | Pick it in any future generation. |
| Training | The engine is still processing. | Wait. The card refreshes by itself when the status changes. |
| Failed | The engine reported an error. | Delete and try again. The most common cause is a sample that was too quiet or too short. |
Creating a voice
There is no inline create form on this page. Both the header Create A Voice button and the topbar + Create Voice button open the same picker. The Create a new voice picker is a small dialog with two cards.| Card | Title | Description |
|---|---|---|
| Clone | Clone a voice | Upload or record a short sample. We will match tone, accent, and pacing. Opens the Clone Wizard. |
| Design | Design a voice | Describe how it should sound, and we will generate it from scratch. Opens the Design Wizard. |
Deleting a voice
Click the Delete action in a card’s footer. A confirmation dialog appears.| Field | Copy |
|---|---|
| Title | Delete this voice? |
| Description | Anyone using this voice will lose access to it. You cannot undo this. |
| Cancel button | Cancel. Closes the dialog with no change. |
| Confirm button | Delete. Styled with the destructive (red) background and white text. Removes the voice immediately. |
Tenant isolation
Every voice is tied to your account. Other users in the same workspace cannot see your custom voices, and you cannot see theirs. Sharing a voice across accounts is not supported.Provider routing
Voices are Wittify voices. The underlying provider (the actual model that produces the audio) is internal routing detail and never appears on the cards. You will never see provider names in the Status, Source, or any other field.Common questions
Can I rename a voice after I create it?
Can I rename a voice after I create it?
Not from this page. The voice keeps the name you gave it in the wizard. Delete and recreate if the name is critical. The cloned audio sample is the slow part, the wizard remembers most of your choices.
Can I share a voice with another teammate?
Can I share a voice with another teammate?
Where do my voices get used by the app?
Where do my voices get used by the app?
Anywhere there is a voice picker: the Studio’s voice card, every wizard step that lets you pick a voice, and the My Voices tab in the Voice Picker modal.
My voice failed during training. Can I retry?
My voice failed during training. Can I retry?
The fastest path is to delete the failed card and run the wizard again. Most failures come from samples that were too quiet, had heavy background noise, or were shorter than the minimum length (3 seconds for cloning).
I do not see my voice on the Studio's voice picker.
I do not see my voice on the Studio's voice picker.
Check the My Voices tab in the picker. The picker uses tabs to separate built-in voices from yours. Voices in Training still show in My Voices but cannot be selected for a generation until they reach Ready.
The audio sample on the card sounds bad. What happened?
The audio sample on the card sounds bad. What happened?
For cloned voices, the sample is the audio you uploaded or recorded. If it is rough, the cloned voice will be too. Re-record from a quieter room, hold the mic 10 to 15 cm away from your mouth, and aim for a 3 to 10 second clip without long silences.
I do not have any voices, but I cannot find the empty-state Create button.
I do not have any voices, but I cannot find the empty-state Create button.
Where to go next
Voice Picker
Browse all voices including your custom ones.
Clone Wizard
Add a cloned voice.
Design Wizard
Add a designed voice.
Studio
Use a custom voice in a generation.

