Documentation menu
API keys & connected appsProjects and versions
How renders, revisions and floor layers are grouped into projects, and how to return to an earlier version.
On this page
A project is the container around one design. Every render of that design — the first draft, the variant with a different style, the version after a material change — is a version inside the same project, in the order it was made.
How projects are named
A project names itself from the earliest description it contains, or from the tool it was created with, and falls back to "New project" if neither gives anything usable. Renaming it takes up to 80 characters, and clearing the name returns it to the automatic one.
Versions
Each version records the source image it started from, the settings, the description and the reference image it was given. Changing a setting for a new render therefore does not rewrite an older version, and Modify the original request restores the whole setup of the version you are looking at — source, words, settings and reference — so one change can be made and re-run without rebuilding the setup by hand.
Versions that failed are not added to the list. A failed image is reported where it happened, can be retried, and does not take a number in the project's history.
Where projects appear
| Place | Address | What it shows |
|---|---|---|
| Workspace | /app, and /app?project=<id> for one project | The current design, its version bar and the open canvas |
| Projects page | /app/projects | All projects with a preview, the version count and the last activity |
| History | /app/history | Renders across all projects, filterable by status, continuing into the workspace |
The history page refreshes itself while a render is running, and opening a card continues that render's project from the version you clicked.
Trash
Moving a project to the trash hides it from the project list, and restores in one click. Trash shows projects placed there in the last 30 days. Only the project's listing is hidden: the versions and result images stay in the task history and in the asset library, so a render is never lost to a tidy-up.
Generating again inside a trashed project brings it back to the list.
Limits worth knowing
The project list shows up to 200 projects, and the workspace loads up to 100 versions of one project at a time. An older project with a very long history reports that it was truncated.
An account can create up to 30 new render plans per hour. Exceeding that returns a rate-limit error rather than queueing.
A plan that was prepared but never submitted expires 30 minutes after it was made.
Related
Library, presets and prompt recipes · Edit a finished render · Download and watermark