Reference prompts
How to use @Image references in prompts
A guide to multi-reference prompting with @Image mentions for subject identity, style, product details, motion, and scene control.
Multi-reference prompting lets a creator upload several assets and point to them inside the prompt. This keeps the interface simple while giving each image a clear job.
Quick decision
Best for
- Prompts that need separate references for subject identity, product shape, lighting, style, and final composition.
- Creators who want to call uploaded assets directly with @Image tokens while writing.
Not ideal for
- One-image tasks where a single reference already contains everything important.
- Prompts where the references have unclear roles and may conflict with each other.
Choose this when
- Each uploaded asset has a specific job, such as @Image 1 for the product and @Image 2 for lighting.
Give each image a role
A useful reference prompt names the role of each asset. For example: use @Image 1 for the product shape, @Image 2 for lighting, and @Image 3 for the final composition.
Do not overload one reference
If one image is expected to control identity, lighting, background, mood, and motion, results become harder to predict. Split important roles into separate references when possible.
What the @ menu should do
When the user types @, the mention menu should appear near the text cursor and list available references. Selecting one should insert the matching @Image token into the prompt.
Quick answers
What does @Image mean?+
@Image is a prompt reference token. It tells the generator which uploaded image should guide a specific part of the result.
Can one prompt use several uploaded images?+
Yes. A prompt can refer to multiple uploads, such as @Image 1 for the subject and @Image 2 for the style.
Why should the mention menu follow the cursor?+
The menu should appear next to the typed @ so users understand that the selected reference will be inserted exactly where they are writing.