Skip to main content

Add references to the prompt box

Preview allows you to add reference images and videos to your prompts. Each model has their own rules and requirements for references. Image models accept image references. Depending on the video model they can accept Images, Videos, Elements or ingredients.
ImageRefmenu

Choose a reference source

You can add references through the prompt box by using:
  • Click to Pick to select any image on the canvas
  • Upload from Device to bring in a local file
  • Choose from Library to pull from saved characters, locations, props, shots, or assets

Add references from canvas controls

If an image or video is already on the canvas, you can also use the target icon on that image and choose Ref. as Image. This is useful when you are iterating quickly and do not want to reopen library menus
Refimagetarget

Reference saved assets by name

Preview’s memory system lets you reference many saved items by typing @ followed by the asset name. This works for:
  • Characters
  • Locations
  • Props
  • Saved assets
  • Shots saved in scenes
    Ref Pill Select Asset
If you have multiple images saved in a single asset name, you will see all available options in this menu. If you type the @name and click Enter, the asset will default to using the first image in the group as reference. If you want to use a different asset from the group simply click on that asset and it will load into the prompt box. You can use the same asset multiple times in a prompt and you can use multiple assets from the same saved character, location and prop. Different models have different limits to how many reference assets can be added, this is represented by a number beside the image/video ref box on the top shelf of prompt box.
Ref Box Number

Video References

Some video models accept video references. When selecting a video ref. Preview will only allow you to choose from video files on canvas, saved to library or uploaded from your computer.
Video Ref Select

How to use the Reference pills

When you use @ to call a saved asset into prompt box you will notice that a reference pill is added into your prompt. Click on that pill to open the reference pill menu. In this menu you can see a thumbnail of the asset being used. You can also swap the asset for another saved Asset by clicking the name or Asset menu above the thumbnail.
Ref Pill Menu
Continue to Prompting best practices for guidance on where to place reference pills and how to phrase prompts around them.