Skip to main content

Templates overview

Save a full workspace configuration as a reusable template. What a template contains, when to save one, and the Free vs Pro matrix.

Last updated April 27, 2026

A template captures every setting that makes a workspace session produce a specific filename shape, so you can reapply it to the next shoot with one click. Templates are Pro-only to save, but every user can apply any of the built-in starter templates.

What used to be "platform presets" was retired in April 2026: there is no preset module anymore, only the Filename Format string. If you want a Shopify- or Amazon-shaped filename, write the format you want — your template owns it end to end. The workspace's Format Builder is the chip-based editor that authors that string for you.

What a template contains

name

Human-readable label, shown in the template picker and the active-template pill.

category

Optional grouping label ('E-commerce', 'Photography', 'Real estate'). Used to organize the picker.

icon

Lucide icon name. Purely cosmetic — shown in the picker and the sidebar active-template card.

filenameFormat

The full Filename Format v3 string this template renames to. Required.

Authored either as a literal string in the template editor or via the workspace Format Builder and promoted with Save as Template. Example shapes: {group}-{descriptor}-{seq:3}{ext} for a manual-grouping workflow, {sku}-{descriptor}{ext} for a generic SKU shape, {date|src=exif|fmt=YYYY-MM-DD}_{val:client}_{val:phase}_{seq:3}{ext} for an event photographer's ISO 8601 ordering. Grammar reference: Token reference.

groupBy

Default grouping axis for sessions using this template. An array of metadata keys.

Examples: ['sku'] for SKU-keyed grouping, ['brand', 'product'] for a composite axis, ['group'] for manual buckets, ['client', 'phase'] for an event photographer's per-shoot organization. The workspace's Group by dropdown lands on this default; users can override it per-session without affecting the template.

requiredMetadata

Optional. Metadata keys this template considers necessary for a complete row, with optional allowed-value lists per key.

Each entry pairs a metadata key with an array of allowed values. Empty array = key is required but accepts any free-text value; populated array = the row's metadata input becomes a dropdown limited to those values. Rows missing any required key surface a warning in the workspace before export. Examples: { client: [], phase: ['prep', 'ceremony', 'reception'] } for a wedding template, { brand: [], product: [], color: [], view: ['front', 'side', 'back', 'detail'] } for an e-commerce template.

humanReadable
default: false

If true, the engine renders filenames in title-cased space-separated form (e.g. `Nike Airmax Front.jpg`) instead of the URL-safe slug shape.

altTextVoice

A prompt-style string spliced into the AI alt-text system prompt when this template is active.

See AI alt text for how voice strings are used. Example: "product-focused, keyword-friendly, 1 sentence emphasizing material + use case".

Free vs Pro

  • Free users can apply any of the built-in starter templates from the toolbar.
  • Pro users can save any workspace configuration as a new template, edit templates from /dashboard/templates, and share templates across every workspace session. Templates are scoped to the authenticated user.

Applying a template

Open the workspace toolbar's Format ▾ menu, click Apply Template in the Templates section, and every listed property gets set in the active session. The active-template pill in the toolbar (and the sidebar card) show which template is in effect; click the X to clear it and the workspace falls back to whatever you last authored in the Format Builder — or to the empty "Choose a format" state if you haven't built one yet.

Applying a template over an existing workspace session is non-destructive to your row metadata — it only changes the filename format, the default grouping axis, the required-metadata expectations, the readable-names toggle, and the alt-text voice. The images themselves and any metadata you already typed (SKU, descriptor, custom keys) are preserved.

Saving a template

Configure the workspace exactly how you want it, open Format ▾ → Save as Template, name it, and pick a category. The template is instantly available in every future session on the same account.

Editing templates is done from /dashboard/templates — see Creating a template for the authoring guide.