Aphera uses tokens in two places: the project naming pattern (Settings → Projects) and the export naming pattern on each preset (Settings → Exports). Tokens are written as {token} and resolved when a project is created or a photo is exported.
The Naming Pattern field provides autocomplete: type { to see the available tokens.
Project Naming Tokens
Used in the naming pattern under Settings → Projects. The default pattern is {date} {name}.
| Token | Description | Example |
|---|---|---|
{name} |
The project name you enter | Joshua Tree Trip |
{date} |
Today’s date in ISO format | 2026-04-24 |
{year} |
4-digit year | 2026 |
{month} |
Zero-padded month | 04 |
{day} |
Zero-padded day | 24 |
Examples
| Naming Pattern | Resolves to |
|---|---|
{date} {name} |
2026-04-24 Joshua Tree Trip |
{name} |
Joshua Tree Trip |
{year}-{month} {name} |
2026-04 Joshua Tree Trip |
{name} ({date}) |
Joshua Tree Trip (2026-04-24) |
Export Naming Tokens
Used in the naming pattern on an Export Preset under Settings → Exports. The default pattern is {preset}/{filename}.{ext}.
Source File
| Token | Description |
|---|---|
{filename} |
Source filename without extension |
{ext} |
File extension for the export format |
Export Run
Resolved once per export.
| Token | Description |
|---|---|
{preset} |
Name of the active Export Preset |
{project} |
Name of the current project |
{date} |
Date of the export, ISO format |
{year} |
4-digit year of the export |
{month} |
Zero-padded month of the export |
{day} |
Zero-padded day of the export |
Numbering
| Token | Description |
|---|---|
{seq} |
Position of the file in the current export batch, 3-digit padded (001, 002, …) |
{version} |
2-digit padded counter (01, 02, …) probed against existing files for uniqueness; useful for re-exporting without overwriting. |
Examples
| Naming Pattern | Resolves to |
|---|---|
{preset}/{filename}.{ext} |
Web/IMG_4032.jpg |
{year}/{month}/{filename}.{ext} |
2026/04/IMG_4032.jpg |
{project}/{preset}/{filename}_{version}.{ext} |
Joshua Tree/Client/IMG_4032_01.jpg |
{preset}/{date}/{seq}.{ext} |
Web/2026-04-24/001.jpg |