Export naming

What downloaded files are called — template, placeholders and preview.

Settings → „Export“ decides what files downloaded from verstag are called. It does not affect storage: internally every file keeps its own identifier.

Only owners and admins may change the template. A member gets a 404 page.

The signed-in product speaks German, so its labels and messages are quoted in German throughout, with the English rendering in italics.

The template

One text field with placeholders in curly braces. The default is:

{original}

Anything that is not a placeholder stays as it is — hyphens, underscores, words of your own. So a template can look like this:

{folder}_{original:slug}_{dimensions}

Below it, a preview shows what a name looks like with your template, on a sample. It updates as you type.

The placeholders

PlaceholderWhat it inserts
{original}Original filename without extension, unchanged
{folder}Folder name, or „unsortiert“ (unfiled) with no folder
{format}Format abbreviation, „freiform“ (free-form) for free-form
{width}Width in pixels
{height}Height in pixels
{dimensions}Both together, e.g. 1080x1350
{date}Date as YYYY-MM-DD
{time}Time as HHMM
{hash}Short identifier of the output
{workspace}The workspace's abbreviation

Date and time are in Central European Time, whatever timezone your account is set to.

Modifiers

After a colon, the value can be changed:

ModifierEffectAvailable on
:upperUpper case{original}, {folder}, {format}, {hash}, {workspace}
:lowerLower casethe same
:slugShort form without umlauts or spaces{original} only

Taking „Kampagne Hero Größe“ as the sample:

TemplateResult
{original}Kampagne Hero Größe
{original:lower}kampagne hero größe
{original:slug}kampagne-hero-groesse
{original:upper}KAMPAGNE HERO GRÖSSE

{original} hands the name back as it was uploaded — capitals, spaces and umlauts intact. :lower only lower-cases it; :slug turns it into a short form with hyphens. Under :upper a German ß becomes a double S, which makes the name one character longer.

Date, time, width, height and dimensions take no modifiers — there is no case in them to change. The reference list in the form shows what each placeholder accepts.

When the template is refused

Four cases, each with its own message at the field:

  • An unknown placeholder. The message names it and lists every one that exists.
  • A modifier that does not exist, or one that would do nothing here. The message says what this placeholder accepts.
  • An empty field. „Die Vorlage darf nicht leer sein.“ (The template must not be empty.)
  • Line breaks or control characters in the field.

While the template is refused, „Vorlage speichern“ (Save template) stays disabled.

Older templates

The placeholders used to have German names — {ordner}, {breite}, {hoehe}, {masse}, {datum}, {zeit}, {tenant} and {original-klein}. Those names no longer work. If your stored template still carries one, downloads are named by the default {original} until you correct it. The form then shows a message naming the replacement.

What happens to the result

The finished name is shortened if it gets too long, and characters that a filename may not carry are replaced — including ones you typed into the template yourself. Filenames have to work on every operating system.

Where two identical names meet in one archive, the second gets a number (foto.jpg, foto-2.jpg). So no file is ever lost, even where the template produces the same name for several outputs.

With the default {original}, the original and the signed output made from it share a name stem. If you keep both side by side, add one more placeholder — {original}_{format}, say.