Invoice RadarInvoice Radar
Export

Patterns

Customize how your invoices are organized when exported

What are export patterns?

Export patterns let you organize your exported invoices into custom folder structures and filenames using placeholders. This helps you maintain a consistent file organization across your exports.

How patterns work

Patterns consist of two parts:

  • Folder pattern: Defines the folder structure (subfolder hierarchy)
  • Filename pattern: Defines how files are named

Example:

  • Folder pattern: {{year}}/{{month}}
  • Filename pattern: {{vendor}}-{{invoiceId}}
  • Result: Files like 2025/03/Acme Corp-INV-2025-001.pdf

Available placeholders

You can use these placeholders in your patterns:

PlaceholderExampleDescription
{{vendor}}Acme CorpCompany name from the invoice
{{invoiceId}}INV-2025-001Invoice identifier
{{year}}2025Year (4 digits)
{{month}}03Month (2 digits, zero-padded)
{{day}}15Day of month (2 digits, zero-padded)
{{currency}}EURCurrency code
{{quarter}}Q1Quarter (Q1, Q2, Q3, Q4)

Custom attributes

Values from your custom attributes can be used in patterns too. Each attribute has a key that Invoice Radar generates from its name, for example "Interne Nummer" becomes interne_nummer. Attribute placeholders always start with attributes. so they never clash with the placeholders above:

PlaceholderExampleDescription
{{attributes.belegnummer}}2025/0412Value of the attribute with key belegnummer

In the pattern editor your attributes appear next to the built-in placeholders, labelled with their name. Click one to insert it.

Example: with the filename pattern {{attributes.belegnummer}}_{{vendor}}, a document whose belegnummer is 2025/0412 from "Acme Corp" is exported as 2025_0412_Acme Corp.pdf.

Number and Yes/No attributes are written as text (4200, true, false). In the live preview, documents that have no value yet show a sample value such as 2026-0042. Only the value ever ends up in a file name, never the attribute's name.

Documents without a value

  • In the folder pattern, an empty attribute is skipped, so the document is placed in the parent folder.
  • In the filename pattern, if a document has no value for an attribute you used, the filename falls back to the invoice number plus the document's unique ID (for example INV-2025-001_co_zAbc123.pdf) instead of a name with a blank part such as _Acme Corp.pdf. The ID is added because invoice numbers are only unique per vendor, so documents without a value never overwrite each other. The same fallback applies if the whole filename pattern is empty.
  • To make an attribute optional instead, wrap it in a section: {{#attributes.belegnummer}}{{attributes.belegnummer}}_{{/attributes.belegnummer}}{{vendor}} gives 2025_0412_Acme Corp.pdf with a value and Acme Corp.pdf without.

Fixed-name destinations (email, sevDesk, Lexware, DATEV, BuchhaltungsButler, Paperless-ngx) do not use patterns and don't support attributes yet.

Preset patterns

Invoice Radar comes with pre-configured patterns you can use as a starting point:

Default

  • Folder pattern: {{vendor}}
  • Filename pattern: {{invoiceId}}
  • Result: Organized by company name

By Year & Month

  • Folder pattern: {{year}}/{{month}}
  • Filename pattern: {{vendor}}-{{invoiceId}}
  • Result: Organized by date, with vendor and ID in filename

By Quarter

  • Folder pattern: {{quarter}}
  • Filename pattern: {{vendor}}-{{invoiceId}}
  • Result: Organized by quarter within the year

Flat Structure

  • Folder pattern: (empty)
  • Filename pattern: {{vendor}}-{{invoiceId}}
  • Result: All files in one folder, named with vendor and ID

Using patterns

In one-time exports

  1. Go to Settings → Export Pattern
  2. Click a preset pattern or customize your own
  3. See a live preview of how your files will be organized
  4. Click Save Export Pattern when satisfied
  5. When you export documents via one-time export, they'll use this pattern

In Folder destinations

The Folder destination offers two options:

  • Same as one-time exports: Uses your saved pattern from Settings
  • Custom pattern: Create a different pattern just for this destination

This lets you organize different destinations differently. For example:

  • One-time exports by vendor
  • Folder destination by date
  • Email destination uses a flat structure

Examples in practice

Given an invoice from "Acme Corp" with ID "INV-2025-001" dated March 15, 2025:

PatternResult
{{vendor}} / {{invoiceId}}Acme Corp/INV-2025-001.pdf
{{year}}/{{month}} / {{vendor}}-{{invoiceId}}2025/03/Acme Corp-INV-2025-001.pdf
{{quarter}} / {{invoiceId}}Q1/INV-2025-001.pdf
(empty) / {{year}}-{{month}}-{{vendor}}-{{invoiceId}}2025-03-Acme Corp-INV-2025-001.pdf

Valid characters

Patterns are converted to valid filenames/folder names. Invalid characters (like /, \\, :, ?, etc.) are handled as follows:

  • The folder separator / in a pattern creates subdirectories
  • Invalid characters inside values (for example a / in a vendor name or attribute value) are replaced with _
  • Leading and trailing spaces are removed

Example: An invoice from "A/B Corp" with pattern {{vendor}}/receipt becomes A_B Corp/receipt.pdf