Skip to main content

Roleplay Templates

Build custom roleplay templates for your organization's specific needs.

Written by Dewey Levi

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]

Did this answer your question?