Skip to content
Introduction Price $49 −$20
ESC

Searching...

Quick Links

Type to search • Press to navigate • Enter to select

Keep typing to search...

No results found

No documentation matches ""

Settings Reference.

Every settings field in InvoiceScript, organized by settings page.

May 20, 2026

Settings Reference

For: admins and owners looking up a specific setting.

Company

Field Description Required
Company name Business name shown on invoices Yes
Email Company email address No
Phone Company phone number 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 Country No
VAT number VAT registration number (shown on invoices when set) No
Tax/Registration number Business registration number No
Default currency Currency for new invoices Yes
Timezone Server timezone for dates 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 Initial counter value (before first finalization)
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 as integer (21 for 21%)
Country Optional country association
UBL tax category S (standard), Z (zero-rate), AE (reverse charge), E (exempt)
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)

PDF

Field Description
Invoice template PDF layout template
Brand color Primary color for PDF invoices and email templates
Logo position Top-left (replaces name), top-center, or top-right

Localization

Field Description
Default locale Application language (13 locales available)
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
Week start Monday or Sunday

Email

Mail delivery is configured during installation. The method (SMTP or Resend) and connection details are stored in the .env file. The sender identity is editable from the settings UI.

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 email Sender email address

Bank accounts

Field Description
Name Internal label
Account holder Name on the bank account
IBAN International bank account number
BIC Bank identifier code
Bank name Name of the bank
Currency Account currency
Default Use as default for new invoices

Item categories

Field Description
Name Category name for organizing catalog items

Users

Field Description
Name User display name
Email Login email address
Role owner, admin, accountant, or employee
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.

Security and session (environment variables)

These settings are configured in the .env file, not through the web UI.

Variable Default Description
SESSION_LIFETIME 120 Maximum session duration in minutes
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.

Ready to build?

One-time purchase. Self-hosted. Own every file forever.

Get InvoiceScript