How Roleplay Templates work
A Roleplay Template is like Yoodli's own templates, such as Cold Call, but your organization makes it. Organization Admins write rules that the AI obeys in every roleplay built from the template. Creators then build and edit the roleplays, but they cannot see or change those rules.
Each template has three parts. They behave differently after a roleplay is built:
Part | What it is | Who sees it | After a roleplay is built |
Core context | Rules for the AI, for example your sales method, policies, or topics to avoid. If the core context and the creator's roleplay context disagree, the AI obeys the core context. | Organization Admins only | Stays linked. An edit reaches every roleplay built from the template at its next practice session. |
Roleplay defaults | Default roleplay context, goals, and AI assets (files the AI reads; members do not see them). | Creators, who can edit them | Copied once. An edit applies only to roleplays created after you save. |
Card details | Name, icon, description, and an AI role label such as "Prospect". The label does not change how the AI behaves. | Everyone | The name and icon show as the type of each roleplay built from the template. |
Who can do what
Role | What they can do |
Organization Admins | Create, edit, preview, publish, archive, and delete templates in Global Content › Roleplay Templates. |
Content Space Admins | Build roleplays from published templates in the Org Roleplay Builder. They can preview a template from its card, but they cannot edit it or see its core context. |
Members | Practice roleplays built from templates. If your organization lets members build roleplays, they can also build personal roleplays from published templates. They cannot use Customize on an organization roleplay that uses a template. |
Create and publish a template
In Global Content, open the Roleplay Templates tab and select Create new. To publish, a template needs these fields:
Name (up to 40 characters)
Description (up to 190 characters), which creators see on the template card
Core context (up to 5,000 characters)
Default roleplay context
Goals and AI assets are optional. You can add Yoodli goals or published Global Goals, and Global files or new uploads. AI assets cannot include images, audio or video files without a transcript, or files that failed to process.
A draft needs only a name. Nothing saves automatically.
To test the template before you publish it, select Preview (or Chat preview in the Preview menu), then choose a content space and a persona.
Template status
Status | Effect |
Draft | Hidden from creators. New and duplicated templates start as drafts. |
Published | Every creator in your organization can build roleplays from it. |
Archived | Hidden from creators. Roleplays that already use it keep working, with its core context. You can publish it again. |
A published template cannot go back to Draft.
Change or remove a template that roleplays use
When you save a published template, Yoodli shows how many roleplays use it. Select Save & update to confirm. Core context edits reach those roleplays immediately.
You can delete a template only when no roleplay uses it. The Used by column shows the count. To stop new roleplays but keep existing ones working, archive the template.
While a template uses a Global file or Global Goal, you cannot delete that file or goal. Remove it from the template first.
How creators use templates
Published templates show first in the Org Roleplay Builder, under All and on a tab with your organization's name. When a creator selects Customize on a template card, Yoodli copies the defaults into a new roleplay.
Creators can also change an existing roleplay to a template in its roleplay type menu. The roleplay keeps its own context, goals, and files, and gets the template's core context. Selecting a Yoodli type removes the template.
Roleplay Agent can also choose a template. It reads the core context and writes its own context and goals, without the template's defaults.
Limits
Templates are not offered in the interview builder.
Generate a deck with AI is not available for roleplays that use a template.
You cannot copy a roleplay that uses a template to another organization, with Copy to org or a content space copy. Copies inside your organization keep the template.
Members see only the templates of the organization they are in now. If a member's personal roleplay uses a deleted template, or one from another organization, practice shows "This roleplay's template is not available in this org."
Still need help? Contact [email protected]
