> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automatstudio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mention Characters, Props & Wardrobe

> Type @ to pull your characters, props, and wardrobe into a shot for consistent results

When you describe a shot, you can reference the characters, props, and wardrobe you have already built by **mentioning** them with `@`. Mentioned assets are pulled into generation as reference images, so they appear consistently across every shot instead of being reinvented each time.

Mentions work in every shot description field — **First Frame Description**, **Edit Description**, **Video Description**, and the **VFX** and **SFX** tabs.

## Add a mention

1. Start typing in any shot description field.
2. Type `@` to open the mention picker. It lists the project's **characters** first, then **props**, then **wardrobe**, each with a thumbnail and name.
3. Keep typing to filter the list by name.
4. Choose an asset:
   * **Click** it, or
   * Use the **arrow keys** to highlight one and press **Enter** or **Tab**.
   * Press **Escape** to dismiss the picker without inserting.

The asset's name is inserted at your cursor as `@Name`, and you can keep writing your description around it.

<Note>
  The mention picker only shows assets that belong to the current project. Build a character in **Character Studio**, a prop in **Prop Studio**, or an outfit in **Wardrobe Studio** first, and it becomes available to mention.
</Note>

## How mentions are matched

* Matching is **case-insensitive** — `@alex`, `@Alex`, and `@ALEX` all resolve to the same character.
* Names that **contain spaces** are supported (for example `@Red Sports Car`).
* When two assets share a prefix, the **longest matching name wins**, so `@Red Sports Car` is preferred over `@Red`.
* A stray `@` that doesn't match an asset — such as an email address or "@ 3pm" — is left untouched and treated as ordinary text.

## What you'll see

Below the description, every resolved mention appears as a badge so you can confirm what the shot will include at a glance:

* **Characters** are shown as blue badges.
* **Props** are shown as violet badges.
* **Wardrobe** items are shown as pink badges.

If a badge you expect is missing, check the spelling against the asset's name in Character, Prop, or Wardrobe Studio.

## What mentions do at generation time

When you generate, Automat Studio gathers the **reference images** for each mentioned character, prop, and wardrobe item and supplies them to the model alongside your prompt. This is what keeps a character's face, a prop's design, or an outfit's look consistent from shot to shot.

The `@` symbols themselves are removed from the text that's sent to the model, so your prompt reads naturally — the mentions act as instructions to the studio, not literal text in the prompt.

<Note>
  Mention the characters, props, and wardrobe you actually want in the frame. Adding a mention pulls that asset's look into the result, while leaving one out keeps it out of the shot.
</Note>

***

<CardGroup cols={2}>
  <Card title="Shot Studio Overview" icon="arrow-left" href="index">
    Previous: shot studio overview
  </Card>

  <Card title="Generate First Frame" icon="image" href="generate-first-frame">
    Next: create the hero still for your shot
  </Card>
</CardGroup>
