Common failures when generating or playing spoken audio.
Generation fails or voices are empty
Cause: ElevenLabs is not connected. The API key comes from PRC_PLATFORM_ELEVENLABS_API_KEY or the elevenlabs_api_key option on Spoken Article → Settings.
Fix: Confirm the constant or option, then reopen the editor. Localized config exposes elevenlabs.connected, not the key.
Player block shows nothing
Cause: No valid spoken-article audio meta for the post, or the block is on an unsupported post type.
Fix: Generate audio from the Spoken Article panel. Confirm add_post_type_support( ..., 'prc-spoken-article' ) for custom types.
Draft vs production quality mismatch
Cause: Per-article spoken_article_audio_quality selects which site model is sent to /elevenlabs/tts. Legacy per-article spoken_article_model is deprecated.
Fix: Regenerate with the intended quality tier after checking Spoken Article → Settings model defaults.
Duplicate or stale parent meta after CPT migration
Cause: Older sites stored spoken data on the parent post. Migration moves it to the spoken-article CPT.
Fix: Follow the Migration guide (wp prc spoken-article migrate).