> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/convai-playground/get-started/creating-a-new-character.md).

# Creating a New Character

Learn how to create and customize a new AI character in Convai Playground, including description, avatar, voice, and language settings.

Create a character in the Convai Playground, then configure its description, avatar, voice, and languages before testing it.

## Step-by-Step Guide

### 1. Access the Creation Tool

* From your **Dashboard**, click **Create a new character** in the top-right corner.

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2F7rLVjmloObMy5X3ovZUW%2FScreenshot%202026-05-08%20135026.png?alt=media&amp;token=2f3f7a60-e2b6-41f2-88db-6b8c0c3b0cdc" alt="Convai Playground dashboard with the Create a new character control"><figcaption></figcaption></figure>

* A new character creation interface will open.
* In the left menu, only **Character Description**, **Avatar**, and **Language and Speech** are active initially. Other sections will unlock after the character is created.

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Fgit-blob-a577cee5c8713f3145c17b463f63610fb9025065%2Fimage.png?alt=media" alt="New character editor with the initial configuration sections available"><figcaption></figcaption></figure>

***

### 2. Character Description

* **Character’s Name** – Enter the name for your character (you can edit this later).
* **Core Description** – Write a short background covering the character’s story, personality details, and distinctive features.
  * Alternatively, click the **Wand Icon** to **Generate Character Backstory with AI**.
* **Speaking Style** *(optional)* – Define the way your character speaks, including tone and mannerisms. Also, feel free to suggest some **Sample Dialogues** here for your AI character.
* **Visibility Settings** – Choose who can interact with your character:
  * **Public** – Available to anyone on `x.convai.com`.
  * **Unlisted** *(default)* – Only accessible via a direct link.
  * **Private** – Restricted to you and invited users.

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Fgit-blob-befd8fe7898605313edc4c1693e271bf807eeee6%2Fimage.png?alt=media" alt="Character Description fields in the new character editor"><figcaption></figcaption></figure>

***

### 3. Avatar Customization

* Click the **Avatar** tab in the left menu.
* Select **Configure Avatar** to customize your character’s visual appearance.
* Follow the steps in the [**Avatar Studio Documentation**](/api-docs/no-code-experiences/avatar-studio-experiences.md) to learn how to adjust facial features, clothing, and other design elements.
* Click **Save Changes** when done.

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Fgit-blob-a18ec5d7882d0d477b660a3730ead25d1aab2813%2Fimage.png?alt=media" alt="Avatar configuration section for a new character"><figcaption></figcaption></figure>

***

### 4. Voice and Language Settings

* Click the **Voice And Languages** tab.
* In **Language**, select one or more languages your character can speak.
* In **Voice**, choose from the filtered voice options for your selected languages

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Fgit-blob-76535ab6aaf6f1253df20380abfa77f884cb56ac%2Fimage.png?alt=media" alt="Voice and language settings for a new character"><figcaption></figcaption></figure>

***

### 5. Finalizing Character Creation

* Once all desired settings are configured, click **Create Character** at the top right.
* If you skip customization, a **random avatar** and **voice** will be assigned automatically.
* If you don't choose any language, **English** will be selected by default.
* You can update any attribute later, so there’s no need to finalize all decisions immediately.

***

## After Creation

When the character is created, all the sections in the left menu become available for deeper customization:

* Character Description (with **Speaking Style** and **Personality Traits**)
* Avatar
* Language and Speech
* Knowledge Bank
* Core AI Settings
* Guardrails
* State of Mind
* [Agentic Actions](/api-docs/convai-playground/character-customization/agentic-actions.md)
* Narrative Design (*Coming Soon to the new Playground. Available on* [*Legacy Playground*](https://playground.convai.com/pipeline/dashboard))
* External API (*Coming Soon to the new Playground. Available on* [*Legacy Playground*](https://playground.convai.com/pipeline/dashboard))
* Publish
* Memory
* Mindview

Each of these features allows you to enhance and refine your character for more natural, intelligent, and engaging interactions. These are covered in separate documentation.

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FtOudgL8koqwWjHxVZHg1%2Fimage.png?alt=media&amp;token=57f70e0e-06f3-4920-88cc-6c47c702fe3d" alt="Character editor navigation after the character has been created"><figcaption></figcaption></figure>

***

## Continue configuring the character

The character creation process in Convai Playground is designed for flexibility — you can launch a character in minutes or spend time refining every detail. Whether you start with default settings or fully customize the avatar, voice, and description.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.convai.com/api-docs/convai-playground/get-started/creating-a-new-character.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.