References
Save a style, a character, a product or a place as a reference, then use it on every image or mention it with @ to keep your work consistent.
Last verified
Overview
A reference is a named set of reference images plus a line on how to use them. Save one to keep a character, a product or a visual style the same across new images.
Each reference has a type, which tells the model what it is. Every request that sends the reference's images says which images they are and what to keep from them, in Create, Batch, the agent and connected AI apps:
- Style: match its look, such as the medium, light and palette, never its subjects.
- Character: keep the face, proportions, clothing and colors the same.
- Product: show it exactly, with its shape, label and colors.
- Place: use it as the setting.
- Brand: use its logo, colors and typefaces where an image has text or a logo.
You can also name a type of your own, such as "pose" or "hand lettering". The agent then follows the reference's note.
References belong to a project, so the references for your picture book don't show up while you're working on app icons. For references every project uses, such as a logo, the workspace has references of its own. Open them from Settings > General > References.
Create a reference
With a project open, select the settings button beside its name at the top of the page to open Project settings. Next to References, select Add, give the new reference a name, and drop your images in.
Already have the right images attached to a prompt? Open the tray menu and choose Save as reference. The images you've attached become a new reference in the current project.
You can also add images from the style library. Select Add to references on any image. With more than one reference, pick where it goes, or choose New reference. The image is copied into your workspace and added to that reference.
The agent saves references as you work, too. When you like a look or want to keep a character, it saves them and says so in a short note under its reply. Open the note to see the reference, where you can edit or delete it.
Use short, descriptive names such as "Pip" or "Summer sky" so references are easy to find.
Tell the model how to use it
Open a reference to set its Type and write its note. Use the note to say what the images are for.
Match the palette, the painted clouds and the soft cel shading. Never copy the subjects or the composition.
The note is added to the start of any prompt that sends the reference's images, right after the line its type adds. Each image can have a short note of its own too, such as "side view" or "logo on dark".
Explain which details matter, such as the palette or pose, and what to leave out.
Both images below used the same hare prompt and Summer sky references. Without a note, the model copied scenery from the references. With the note, it used more of their colors and shading instead.
The result still includes a puddle from one reference. Review each image and clarify the note if unwanted details recur.
Auto-attach it to every image
Check Auto-attach on a reference, and every image you make in the project uses it, in Create, in agent chats, in new batches and from connected AI apps, without being mentioned. It suits the project's style. An auto-attached reference shows a small blue paperclip on its thumbnail in the project's list and in the Create tray, and Auto-attached under its name. In Create, the reference starts in the tray like one you attached, and what the tray shows is what the image uses. Remove it from the tray to leave it off one image; it's back for the next one. Video doesn't use it. Turn it off with the same checkbox, or with Auto-attach in the reference's menu.
Mention a reference
Type @ in the prompt and pick a reference. In Create, its images land in the tray, the same as if you'd attached them yourself, and you can remove any you don't need for this one image. The menu lists Browse styles first, followed by your references and latest images. Choose Browse styles to see the style library.
In an agent chat, @ lists the project's references by type, then the workspace's. The one you pick goes with that message.
You can mention more than one reference. A common pairing is a character and a style.
Choose images for one request
In Create, select a reference's pile in the tray to see its images. Uncheck any you don't want for this request; the reference itself doesn't change, and the next request starts with all of them again. An image the model has no room for says Won't fit. In Batch, open a row's References cell and click the count beside a reference, All until you change it, to see its images. Click a picture to leave it out of that row.
After an image is made, its details say what each reference sent, such as "Sent with Brand look (4 of 12), Mira and Ghibli style (2 of 4)". A reference the model had no room for at all isn't listed.
Organize
Open a reference's menu to Rename it, Move to another project, or Duplicate to another project when two projects share a look. Drag images inside a reference to reorder them.
To add a single image, right-click it in the feed or the library, choose Add to references, then pick the reference.
Delete reference removes it straight away, without asking. Images you've already generated with it stay as they are, and so do the images it held.
Limits
- A reference holds up to 12 images.
- A project can have up to 10 references.
- Some models accept fewer reference images than others, and a few accept none. The Models table lists how many each one takes, so check it before you attach a big reference.
- When the references on a request hold more images than the model takes, images you attached yourself go first. Then each reference and the style take turns: each sends its first image, then each sends its second, and so on until the model is full, so a big reference never crowds out a small one or the style. A reference with no room left is left off that image, and so is its note. Put a reference's most important images first; drag them in the reference to reorder.
FAQ
Do references guarantee the same character every time? No. References steer the model strongly, but each model follows them differently. If a result drifts, add a note that says what must stay fixed. On Nano Banana 2 Lite, which isn't built for several references at once, move up to Nano Banana 2.1.
Can my teammates use my references? Yes. Everyone in the workspace sees the project's references.