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:
| Placeholder | Example | Description |
|---|---|---|
{{vendor}} | Acme Corp | Company name from the invoice |
{{invoiceId}} | INV-2025-001 | Invoice identifier |
{{year}} | 2025 | Year (4 digits) |
{{month}} | 03 | Month (2 digits, zero-padded) |
{{day}} | 15 | Day of month (2 digits, zero-padded) |
{{currency}} | EUR | Currency code |
{{quarter}} | Q1 | Quarter (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:
| Placeholder | Example | Description |
|---|---|---|
{{attributes.belegnummer}} | 2025/0412 | Value 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}}gives2025_0412_Acme Corp.pdfwith a value andAcme Corp.pdfwithout.
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
- Go to Settings → Export Pattern
- Click a preset pattern or customize your own
- See a live preview of how your files will be organized
- Click Save Export Pattern when satisfied
- 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:
| Pattern | Result |
|---|---|
{{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