Settings reference

For: admins and owners looking up a specific setting.

Open a settings page from the overview or the searchable Settings location control. Value dropdowns support search and keyboard selection. Country codes, currency codes and timezone identifiers keep their stored meaning. Escape closes a list without changing the current choice. A refused save retains your input and identifies the affected fields.

Company

Pepper uses fixed interface colors. To change document colors, use Settings > PDF & branding.

Field	Description	Required
Company name	Business name shown on invoices	Yes
Email	Company email address	No
Phone number	Company phone number	No
Contact person for invoices	The person customers contact about an invoice. The XML export writes this name	No
Website	Company website URL	No
Logo	Company logo (PNG/JPG, max 2 MB, 200-2000 px)	No
Street address	Street and number	No
City	City name	No
Postal code	ZIP or postal code	No
State/Province	State, province, or region	No
Country	Search by name or code. Stored as the two-letter ISO country code	No
VAT number	VAT registration number (shown on invoices when set). A number that starts with NL must have the format NL123456789B01	No
Tax number	Business registration number	No
Electronic address scheme	Identifier type for structured XML files, from the Peppol Electronic Address Scheme list	No
Electronic address	Identifier in the selected scheme, saved without spaces. Enter it together with the scheme	No
Default currency	Currency for new invoices and catalog items. Saved records keep their own currency	Yes
Business timezone	The timezone of today's date for new documents, due dates, overdue invoices, reminders, report periods and recurring invoices	Yes

Invoicing

Document numbering (per type)

Field	Description
Prefix	Text prefix for document numbers (INV, CN, Q, PF, or custom)
Format	Number pattern (six options)
Counter digits	Minimum digit padding (1-6)
Starting number	Counter of the first finalized document. Locked after you save a value above 1 or finalize the first document. No document can choose its own number
Year reset	Reset counter to 1 each calendar year (requires year in format)

Tax rates

Field	Description
Name	Display name (shown on invoices)
Rate	Percentage with up to two decimals, in your number format (21 for 21%, 9,5 for 9.5%)
Country	Optional country association
UBL code	S (standard), Z (zero-rate), AE (reverse charge), E (exempt)
Exemption code (VATEX)	For E and AE rates. AE uses VATEX-EU-AE. Not allowed on S and Z rates
Exemption reason	Text for E and AE rates. Not allowed on S and Z rates. E and AE rates need a code or a reason
Default	Mark as default for new line items

Invoice defaults

Field	Description
Default due days	Number of days from issue date to due date (new invoices)
Require e-invoice readiness	Never, customers with an electronic address, or every invoice and credit note. The default is Never

See Require e-invoice readiness for the checks and refusal steps.

PDF

Field	Description
Invoice template	PDF layout template
Document brand color	Color for PDFs and public quotes. The app keeps its own interface colors
Logo position	Top-left (replaces name), top-center, or top-right

PDF settings apply to new documents. A finalized document keeps the template, color and logo position it had at issue.

Localization

Field	Description
Language and region	26 regional choices supply notation defaults and the company language. Saved overrides and company currency stay unchanged. A customer’s Document language remains independent
Date format	Display format for dates (2026-05-20, 20/05/2026, etc.)
Time format	24-hour or 12-hour clock
Number format	Decimal and thousands separators, for display and for typing amounts, quantities and rates
Week start	Monday or Sunday

An overridden notation field shows its selected region’s default. Reset to defaults uses that region. Save a changed region before you reset. Existing installations retain their notation as overrides.

A finalized document keeps the number and date formats it had at issue.

Email

Set up mail delivery during installation. Pepper stores the method (SMTP or Resend) and connection details in the .env file. You can edit the sender identity in settings.

Settings > Email and Settings > Reminders also show mail and scheduler health. They list each job’s last attempt, completion, success and failure, plus delivery counts and links to recent deliveries. A warning means the outbox has not checked in for five minutes. See Check the scheduler.

SMTP fields (when `MAIL_MAILER=smtp`)

Field	Description
SMTP host	Mail server hostname
SMTP port	Mail server port (587, 465, or 25)
Encryption	TLS, SSL, or none
Username	SMTP authentication username
Password	SMTP authentication password

Resend fields (when `MAIL_MAILER=resend`)

Field	Description
Resend API key	API key from resend.com

Sender identity

Field	Description
From name	Sender name on outgoing emails
From address	Sender email address. When empty, Pepper uses the mail configuration in `.env`

Mail timeout (environment variable)

Variable	Default	Description
`MAIL_TIMEOUT`	`30`	Seconds Pepper waits for the SMTP server before it stops an attempt

Bank accounts

Field	Description
Name	Internal label
Account holder	Name on the bank account
IBAN	International bank account number. The form checks the check digits. Enter an IBAN or an account number
Account number	The account number of an account without an IBAN, as customers must type it
Routing code	Sort code, ABA routing number, BSB or IFSC, if the bank uses one
BIC	Bank identifier code
Bank name	Name of the bank
Currency	Account currency
Default	Marks the account in the list. It does not select the account on new documents
Active	On by default. New documents offer active accounts only

A finalized document keeps the bank details it had at issue.

Item categories

Field	Description
Name	Category name for organizing catalog items

Accounts

Owners and admins manage accounts in People, on each person's account page. Earlier versions had a Users settings page; its address now opens People.

Field	Description
Name	User display name
Email	Login email address
Role	Owner, Admin, Accountant, Employee or a custom role
Status	Active or deactivated

Supported locales

English, German (Deutsch), Dutch (Nederlands), French (Français), Spanish (Español), Italian (Italiano), European Portuguese (Português), Brazilian Portuguese (Português do Brasil), Polish (Polski), Turkish (Türkçe), Japanese (日本語), Chinese (中文), Arabic (العربية), Indonesian (Bahasa Indonesia).

Arabic uses RTL layout. European and Brazilian Portuguese have separate strings. The 14 language variants share 26 regional choices.

See Localization for defaults, browser precedence and your saved personal preference.

Security and session (environment variables)

Change these settings in the .env file. The web UI does not offer them.

Variable	Default	Description
`SESSION_LIFETIME`	`120`	Idle session-data lifetime in minutes; active requests refresh expiry
`SESSION_IDLE_TIMEOUT`	`30`	Minutes of inactivity before automatic logout (0 to disable)
`SECURITY_HSTS_MAX_AGE`	`31536000`	HSTS header max-age in seconds (only sent on HTTPS)
`SECURITY_CSP`	Restrictive default	Content Security Policy header value (empty to disable)

See Security for full details.

Invitations, account roles and guest scopes are in People, for owners and admins.

Page	Purpose	Who changes it
Roles	Custom sets of permitted actions	Owner or Admin
Modules	Modules, their dependencies, permissions, records and tools (read only)	Owner, Admin
Security	Required two-factor sign-in and OpenID Connect SSO	Owner
Agent connections	Expiring external HTTP access	Owner
Optional suggestions	Provider settings and a synthetic connection test	Owner

Your profile > Security controls your own two-factor sign-in and signed-in devices. See Security and Roles and permissions.