Filename Templates
Name Proofed's cut, proof, and cropped files exactly the way your production workflow expects — every placeholder documented, with a live builder.
Every file Proofed generates — cut PDFs, proof PNGs, cropped PDFs — is named by a template you control. Set it once in Settings → Filename template and every download lands ready for your production folder structure, no renaming.
Build one live#
Type a template (or click placeholders to add them) and see the generated filename update instantly. The logic below is exactly what the app runs.
Build your filename template
Generated filename
1049-holographic-circle-stickers-front-60x60mm-q50-v2-cut.pdf
Try clearing a field — empty placeholders collapse their separators, so you never get dangling hyphens.
Every placeholder#
| Placeholder | Renders as |
|---|---|
{orderNumber} | Shopify order number, e.g. 1049 |
{productSlug} | Slugified product title, e.g. holographic-circle-stickers |
{label} | The artwork label, e.g. front |
{quantity} | Line item quantity |
{version} | Proof version number |
{customerName} | Slugified customer name |
{shopName} | Slugified shop name |
{date} | Generation date, YYYY-MM-DD |
{unit} | Your dimension unit: mm, cm, or in |
{type} | cut, proof, or cropped |
{ext} | pdf or png (appended automatically if omitted) |
{Width} / {Height} | The line item's Width / Height custom attributes |
{prop:KeyName} | Any line-item custom attribute, matched case-insensitively — e.g. {prop:Material} |
The default template#
{orderNumber}-{productSlug}-{label}-{Width}x{Height}{unit}-q{quantity}-v{version}-{type}
For order #1049, a 60 × 60 mm front design, quantity 50, version 2, that produces:
1049-holographic-circle-stickers-front-60x60mm-q50-v2-cut.pdf
Smart cleanup rules#
You never get broken filenames from missing data:
- Values are sanitised — lowercased, accents flattened (é → e), unsafe characters removed, spaces become hyphens, segments capped at 60 characters.
- Empty placeholders collapse — if an order has no
Widthattribute,-{Width}x{Height}{unit}-simply disappears instead of leaving--x-debris. No dangling hyphens, ever. - The extension is guaranteed —
.pdf/.pngis appended if your template doesn't end with it.
Using {prop:...} with your checkout personalisation fields is the power move — e.g. {orderNumber}-{prop:Material}-{prop:Finish}-{type} names every file with the exact production specs your team needs to see at a glance.
Related guides#
- Cut Files & the Design Editor — the files this template names
- Shopify Integration — how line-item custom attributes reach Proofed
Was this helpful? If something isn't working, contact support.