Browse the manual
Settings reference
Every settings field in Made with Pepper, organized by settings page.
On this page
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
Made with Pepper uses fixed interface colors. To change document colors, use Settings > PDF & branding.
| Field | Description | Required |
|---|---|---|
| Company name | Business name shown on invoices | Yes |
| 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 |
Payment terms
| Field | Description |
|---|---|
| Default due days | Number of days from issue date to due date (new invoices) |
| 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 |
|---|---|
| Application language | Interface language and company language for documents and emails (13 locales available). A customer's Document language overrides it for that customer |
| 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 |
A finalized document keeps the number and date formats it had at issue.
Set up mail delivery during installation. Made with 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, Made with Pepper uses the mail configuration in .env |
Mail timeout (environment variable)
| Variable | Default | Description |
|---|---|---|
MAIL_TIMEOUT |
30 |
Seconds Made with 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 |
Users
| Field | Description |
|---|---|
| Name | User display name |
| 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), Portuguese (Português), Polish (Polski), Turkish (Türkçe), Japanese (日本語), Chinese (中文), Arabic (العربية), Indonesian (Bahasa Indonesia).
Arabic uses RTL layout. Portuguese is European Portuguese. The interface, the PDFs and the emails are available in all 13 languages.
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.
Related pages
Access and sign-in controls
| Page | Purpose | Who changes it |
|---|---|---|
| Users | Invitations, account roles and guest scopes | Owner or Admin |
| Roles | Custom sets of permitted actions | Owner or Admin |
| Modules | Enabled optional areas and their dependencies | Owner |
| 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.
Need help with the product?
Contact support