> ## 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).

# Remove character

# 🟧 Remove character

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

The **Remove character** block takes a character that is currently on screen off the stage, with an exit animation.

It also frees the slot the character occupied in the Scene block's grid: that slot becomes available for another character.

## 📥 Inputs

*   **in (Flow)**: Entry point. As soon as the flow arrives, the character leaves the stage; the flow resumes once the exit is over.
*   **character (Character reference)**: Dropdown listing the module's characters. This block offers **no** mood dropdown: it removes the character whatever mood is being shown.
*   **transition (Choice, default "instant")**: How the character leaves. `instant` makes it disappear at once, with no animation; `upwards`, `to the right`, `downward` and `to the left` slide it off screen through the matching edge; `fade out` fades it away.
*   **duration (Number, default 0.4)**: Length of the exit animation, in seconds. Has no effect with the `instant` transition.

## 📤 Outputs

*   **out (Flow)**: The flow resumes once the character has left the screen.

## 💡 Example

**Scenario: the bookseller heads to the back room**

1. The bookseller is on stage, on slot 3, from an Add character block.
2. The dialogue ends with "Let me go and fetch it for you."
3. A Remove character block targets "Bookseller", transition `to the right`, duration 0.6: she slides off the right edge over 0.6 s.
4. Slot 3 is free again: an Add character block can put "The shop cat" there.
5. The flow continues with a narrator Dialogue block during the wait.

## ⚙️ Technical Details

*   **Internal ID**: `removeCharacter`
*   **The character must be on stage**: if the targeted character was never added (or has already been removed), the block does nothing and the flow carries on normally, with no warning. Same thing if no Scene block has run upstream: with no grid of slots, the block is inoperative.
*   **`instant` transition**: for an image-based character the disappearance is immediate, with no animation, even if you entered a duration.
*   **Removing is not hiding**: the character's graphic object is destroyed. To bring it back you need a new Add character block, re-picking its slot, its depth and its mood — nothing is remembered.
*   **Other ways off the stage**: a character can also leave the screen without this block — when a Scene block runs again (every character leaves with a fade out), or when an Add character block targets an occupied slot while the stage is full.
*   **"Disable every transition and delay" setting**: when it is on in the module settings, the duration is ignored and the exit is immediate.

## 🔗 See also

*   **Add character**: the symmetrical block, to bring a character in.
*   **Scene**: running a scene again automatically removes every character present.

---

*Documented version: v1*