> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🟧 Edit character

# 🟧 Edit character

${frame}[Video: anatomy of the Edit character block](https://celestory-docs-videos.netlify.app/en/anatomie-bloc/editcharacter.html)

![Edit character](https://celestory-docs-illustrations.netlify.app/en/Editcharacter_EN.svg)

The Modify character block allows you to dynamically update the attributes and visuals of a character during the execution of the application (e.g. chatbot), without having to recreate a new character.

This block is particularly useful for reflecting changes in the emotional or contextual state of a character (eg: transition from "Happy Bob" to "Sad Bob") by modifying its avatar, its text style or its animation effects.

## 📥 Entries

- in (Flow): The narrative flow triggering the character modification.
- character (ChatbotCharacterRef): Static reference of the character to modify.
- image (Image): (Optional) New image resource for the character avatar.
- entranceEffect (Animation): (Optional) Animation effect when the character appears (e.g. entry from the left).
- textStyle (TextStyle): (Optional) Text style applied to character messages (font, color).
- borderImage (Style): (Optional) Style of chat bubbles (background, border) — not a plain image, but a style resource that can itself contain an image.

## 📤 Outings

- out (Flow): Outgoing flow activated after applying changes to the character.

## 💡 Example of use

Scenario: Emotional evolution of a character in a quiz

1. A “Quiz Master” character is created with a neutral avatar and a blue text bubble.
1. The user correctly answers a difficult question.
1. The Edit Character block is triggered to target “Quiz Master”.
1. The image entry is updated with a smiling avatar, and textStyle turns green.
1. During the next interaction, the character appears with their new style, reflecting their satisfaction.

## ⚙️ Technical Details

- Options management: Optional entries not provided retain their previous value.
- Performance: Modifications are applied in real time without reloading the character.
- Compatibility: Works with all blocks displaying characters (eg: showText, showCharacter).

---

*Documented version: v1*