🏷️ Naming Guide

Filename Tokens & Patterns

Create reusable file naming conventions with metadata-driven tokens and live preview ideas.

Quick Reference

The most commonly used tokens in the app.

TokenDescription
{date}Current date in YYYY-MM-DD format
{datetime:%FORMAT}Custom formatted date/time
{title}Photo title from metadata
{description}Photo description from metadata
{creator}Creator / artist name
{camera_model}Camera model used
{lens_model}Lens model used
{sequence:N}Sequential number with padding
{original_name}Original filename without extension
{userid}User identifier
{copyright}Copyright information
{rating}Photo rating (0-5)

Token Details

How each token behaves in filename patterns.

{date}

Current date in ISO format.

{date}_{original_name}

{datetime:%FORMAT}

Use any `strftime` format you want.

{datetime:%Y%m%d_%H%M%S}_{original_name}

{title}

Uses XMP title or EXIF description.

{date}_{title}

{description}

Longer description from XMP.

{userid}_{description}_{sequence:03d}

{creator}

Photographer or artist name.

{creator}_{date}_{original_name}

{camera_model}

Camera body name from EXIF `Model`.

{camera_model}_{date}_{sequence:04d}

{lens_model}

Lens model when available in the metadata.

{lens_model}_{original_name}

{sequence:N}

Zero-padded numbering for series and batches.

{sequence:03d}
{sequence:04d}

{userid}

Your custom user identifier or account name.

{userid}_{date}_{title}

{copyright}

Copyright or rights owner text.

{date}_{title}_©{copyright}

{rating}

Rating token for filtering or organizing picks.

{rating}star_{date}_{original_name}

Pattern Examples

Some practical combinations you can copy and tweak.

Simple dated filename

{date}_{original_name}.jpg

Example output: 2026-04-02_vacation.jpg

Event workflow

{datetime:%Y%m%d_%H%M%S}_{creator}_{sequence:03d}

Great for photos that need strict ordering.

Readable archive

{creator}_{title}_{date}

Useful when human-friendly file names matter.

Portfolio export

{rating}_{camera_model}_{original_name}

Handy when sorting by camera and favorite shots.