# Animation & Expression Settings

## Make Your Avatar Come Alive

Convai’s Avatar Studio lets you fine-tune how expressive your avatar is — from subtle facial expressions to full-body gestures and smart actions.

## **Facial & Body Animation**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcHe24cCMCm8bSddWh2X-kQZrJ9naojCb0sU292DyBN8hcXc3a4zkISO97CLJ3O3bfhAZfXLfVlwN9v-OvWZBYlIiBF-dFhZ8HIqFh7-2adYZtDLA8T88LEVhUZFUvOWW7aQqWIMQ?key=UBmSq8Y7gM25yDvVwPYY7g" alt=""><figcaption></figcaption></figure>

Use sliders to define the intensity of animations:

* **Facial Animation**
  * Range: **-1 to 1**
  * Lower values result in **minimal expressiveness**, while higher values make your avatar more **emotionally responsive**.
* **Body Animation**
  * Range: **Low to High**
  * A low setting keeps the avatar **more static**, while high adds **dynamic hand and body movements** for livelier interaction.

## **Initial Facial Expression**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfMnjt0UNSvXZBBnmI9mHDxR8JVsCyHR97F9wm_zZaASq8SFaTWSwlio4FBw8B80dxo7KlAoxnso7DS_SCYjizstBZZRyyeinQA-xhrgu6a_6bpx63dUmaeHo_Ug9SLZWWePjcyOg?key=UBmSq8Y7gM25yDvVwPYY7g" alt=""><figcaption></figcaption></figure>

* **Camera Focus Toggle**\
  Enable or disable eye contact with the user by toggling **camera focus**.

You can define how your avatar appears at the start of an interaction:

* **Enable or Lock Expressions**\
  Use toggles to either:
  * Allow expressions to change during conversation
  * Lock the avatar into a specific expression
* **Select an expression** from the dropdown:
  * Joy
  * Trust
  * Fear
  * Surprise
  * Sadness
  * Disgust
  * Anger
  * Anticipation
  * And more...

## **Custom Actions**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfGgtVHsM6OSltBs_dxEZGYBSxwn1osw6i7yygz8I8evCkj2fZ5DT6Q3_psB-Uc2Xw-FWM8rgwxUmm91brN9cl_BYW1QWqGoGyPNZVKG0kyKUs3T8t-5ImhPsf-ILT96uux5_h0?key=UBmSq8Y7gM25yDvVwPYY7g" alt=""><figcaption></figcaption></figure>

Give your avatar intelligent behaviors during interactions — like waving hello or thinking.

**How to Add a Custom Action:**

1. Click **“Add a new action”**.
2. Toggle **Eye Focus** on or off.
3. Click **“Select animation”**.
4. Choose from available animations (e.g., **Wave Animation** for greeting).
5. Name your action (e.g., **Waves Cheerfully**).
6. Click **“Preview Animation”** to test how it looks.


---

# Agent Instructions: 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:

```
GET https://docs.convai.com/api-docs/no-code-experiences/avatar-studio-experiences/customizing-your-avatar/animation-and-expression-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
