Skip to main content
Voice Sharing lets you publish one of your custom voices (cloned or designed) to the Voice Library, making it available publicly to all Inworld users. It’s the easiest way to share a voice you created with the wider community, and to find voices other people have published.
You always remain the owner of a voice you share. Publishing makes it discoverable to others, who can generate audio with it but cannot edit it, re-clone it, or take ownership — and you can remove it from the library at any time. By publishing, you grant Inworld a license to host and distribute the voice; see the Voice Library Addendum.

​
Publish a voice to the Voice Library

1

Open the voice in the Voice Library

In Portal, go to Voice Library and select one of your custom voices to open its details panel. Only custom voices you own can be published.
2

Click “Publish to Voice Library”

Click Publish to Voice Library.Review the voice’s details (name, description, tags) — these are shown publicly and are locked after publishing. Make sure they’re accurate and free of anything you wouldn’t want public before continuing.
3

Accept the Voice Library Addendum

Confirm that you have the right to share the voice and agree to the Voice Library Addendum.Click Publish to Voice Library. Now the voice is published and is discoverable to all users.
After a voice is published, its display name, description, and tags can no longer be edited — other users and applications may be relying on them. If you need to change these details, contact support@inworld.ai.

​
Remove a voice from the Voice Library

You can unpublish a voice at any time from the same details panel (Remove from Voice Library). To avoid disrupting projects that already depend on it, removal follows a 2-year notice period:
  • The voice stays available in the library for the duration of the notice period (but new users will no longer see the voice in the Voice Library UI).
  • After the notice period elapses, the voice is fully removed from the library. It remains in your own workspace as a private custom voice.
If you change your mind during the notice period, you can click Cancel Removal.

​
Discover and use community voices

Shared voices show up in the Voice Library in Portal alongside Inworld and your own voices. You can star a voice to save it, and use the Source filter to narrow the list to Inworld, your own, or community voices.

​
Using community voices via the API

Community voices are fully usable through the public Voice and TTS APIs. The one thing to know up front: a shared voice has two IDs.
IDLooks likeWho sees it
Private voice ID{workspace}__{voice}The owner only
Public (community) voice IDcommunity-…Everyone — use this to browse, fetch, and synthesize
When you browse the library as a non-owner, each voice is returned with its public community-… ID (the owner’s workspace is never exposed). Owners see their original resource name, with the public ID available on the voice’s sharing.publicVoiceId field.

​
Browse the community library

By default, List voices returns your workspace’s own voices plus Inworld system voices — community voices are not included. To browse the community library, add the filter community = "true": 
curl --get 'https://api.inworld.ai/voices/v1/voices' \
  --header "Authorization: Basic $INWORLD_API_KEY" \
  --data-urlencode 'filter=community = "true"'