Review and publish a reference
Improve a character, style, product or place without losing what worked: review its changes, ask the Assistant to check the text against the pictures, and publish the next version.
A published reference never changes: everything made with it keeps using that version until you publish the next one. This guide takes a character from v1 to v2.
1. Make your changes
Open the reference’s page from the Space’s Intelligence tab, and change what you need:
- approve a picture, or move one to Inspiration;
- add a picture with + Add, or drop one onto the page;
- give a picture a role, or reorder them;
- edit a picture in the image editor, such as changing the hair colour;
- edit its documents, or add a style or another reference it depends on.
Each is an unpublished change. The status at the top right says how many, such as v1 · 3 changes. What you make meanwhile still uses v1.
[screenshot: desktop 1440×900 — a character’s reference page with “v1 · 3 changes” and Review changes at the top right, one picture marked with a small amber dot]
2. Review the changes
Choose Review changes. It shows exactly what changed since v1: the primary document line by line, supporting documents, pictures (an edited picture with its before), roles and relationships.
[screenshot: desktop 1440×900 — Review changes for a character: the document’s changed lines, an edited picture shown before and after, a new role, and Publish v2 at the foot]
3. Ask the Assistant to check
If you changed a picture, its text may be out of date. Choose Ask the Assistant to check: it puts a message in the Space’s Assistant with the changed pictures attached. Send it, and the Assistant compares them and proposes:
- revised text, and what it changes;
- which other pictures now look out of date, and why.
Nothing changes until you choose Apply to draft. Remove unlinks an out-of-date picture from the draft; the image stays in the Space. Nothing is regenerated, replaced or published for you.
4. Publish
Back in Review changes, describe the version if you like (“Yellow hair”), then choose Publish v2.
From now on, naming the character uses v2. An earlier version is still there when you want it: write @character-jax@v1. Open Version history from the status to see what each version pinned.
Tips
- Publish a style before the characters that use it: publishing a character pins its style’s version.
- When a style is published again, a character keeps the version it pinned. Its page says a newer style exists: publish the character again to adopt it.
- An image’s How this was made says which version it used, and when a newer one exists. Run again uses the newest; the image itself never changes.
See Publishing versions and When pictures and text drift apart.