The default install works, but it looks and behaves like a demo: stock invoice design, default numbering, default emails. These ten customizations make Invoice Ninja yours — the design, the data fields, the tax setup, and the unglamorous ops work that keeps a self-hosted install healthy.

1. A custom invoice design

Invoice Ninja has a visual designer where you pick fonts, colors, and which columns appear — and if you want more, custom CSS is allowed in your own design copy. The agent can rebuild your layout so quotes and invoices match your brand, drop columns you never use, and put your payment details in the footer. Try: “Make my invoices match my brand — dark blue headings, my logo top-left, hide the discount column since I never use it, and put my IBAN in the footer.”

2. Custom fields that appear on the PDF

Corporate clients want a PO number on every invoice; your bookkeeper wants a cost code on expenses. Custom fields exist for exactly this, and each one can be shown on the PDF and in the client portal. The agent can add them across the right entities and update the email template to mention the PO. Try: “Add a PO number field to invoices and show it on the PDF right under the invoice number, and add a cost code field to expenses for my bookkeeper.”

3. Numbering scheme and counters

Invoice and quote numbers come from a pattern with a counter, and the scheme is yours to define: a prefix, the year, and padded digits, with counters that can reset each January. If you run two brands, groups get their own sequences. The agent sets the pattern, fixes the next number, and checks nothing collides. Try: “Number invoices as INV-year-4 digits, restart every January, and give quotes a Q- prefix so the sequences never overlap.”

4. Tax setup done right

The tax engine has real choices: line-item versus total, exclusive versus inclusive pricing, compound rates. Get them wrong and every invoice is subtly off. The agent can define your named rates, set line-item exclusive pricing, make one rate the default, and show you a test invoice before committing. Try: “Set up two French VAT rates — 20 percent standard, 10 percent reduced — line-item taxes, exclusive pricing, and 20 percent as the default on new invoices.”

When it is done, ask for a test invoice at each rate and check the math on the totals. That two-minute check is worth it: a tax misconfiguration is the hardest mistake to unwind at year end.

5. Email templates and reminders in your voice

Every outgoing message has a template: the invoice email, the payment receipt, and the three reminders. The defaults read like a form letter. The agent can rewrite them in your tone — friendly first reminder, firm third — and preview exactly what a client will receive. Try: “Rewrite the invoice email in plain friendly English, shorten the payment receipt to two lines, and make the third reminder firm but not threatening.”

6. Payment gateways, done properly

Connecting Stripe or PayPal is more than pasting keys: there is test mode, webhooks, and the fee question. The agent can run a real test charge, go live, and set a gateway surcharge so processing fees stop eating your margin on larger invoices. Try: “Connect Stripe in test mode, run a 1 dollar test charge, then go live and add a 2.9 percent surcharge so the fees stop coming out of my invoices.”

It can also make sure the payment link rides along on every invoice email, so a client without a portal login still pays in one click. If you take PayPal too, it gets the same treatment — tested before it is live.

7. White-label the PDFs and client portal

By default, PDFs and the portal carry Invoice Ninja’s branding. The white-label option removes it. The agent can guide the purchase, apply the license key, and point the client portal at your own subdomain so the whole payment experience is under your name. Try: “Get the white-label license applied so the PDFs and portal carry only my brand, and set the client portal to billing.mycompany.com.”

8. Prove the scheduler is running

Self-hosted Invoice Ninja depends on a cron job firing every minute to send recurring invoices and reminders. If that cron is missing, everything looks fine and nothing goes out on time. The agent can check the cron entry, read the scheduler log, and fix missed runs — plus set up a queue worker if your volume justifies it. Try: “Check that the Invoice Ninja cron is installed and firing every minute — a recurring invoice went out late last week — and show me the last scheduler log lines.”

Nobody thinks about this until something stops going out. On a container install the cron often lives outside the app itself, which is exactly why it silently fails. The agent knows where to look.

9. Backups with a tested restore

A backup you have never restored is a hope, not a plan. The agent can set up a nightly job that dumps the database and snapshots the uploaded files with 14-day retention, copies the latest off the server, and runs a monthly test restore into a scratch database. Try: “Set up a nightly backup of the database and uploaded files, keep 14 days, copy the latest off this server, and once a month verify a restore actually works.”

The uploaded files matter as much as the database — your receipts and generated PDFs live there. Ask for a one-page restore runbook once the backup is in place, so any admin can recover the app without the agent.

10. Lock down the install

The app holds your financial data, so spend an hour on hardening. The agent can enforce two-factor for every user, rotate old API tokens, route email through your SMTP provider instead of the server default so invoices stop landing in spam, confirm HTTPS and the app URL match, and make sure the client portal does not allow public signups. Try: “Turn on two-factor for all users, rotate the API tokens, wire email through my SMTP provider, and check that the client portal does not allow public registration.”

One note on email: if clients keep saying invoices land in spam, the fix is almost always authenticated SMTP rather than wording. The agent can send a test message after the change and read the headers to confirm it is signed properly.

See it in action

Official walkthroughs from the Invoice Ninja team:

Worth a watch next:

• Custom Fields – Invoice Ninja — the official walkthrough for the custom-fields customization described above.
• Invoice Ninja Setup – (React) — a full setup tour of the current interface before you start customizing it.

Do these once and the app stops feeling rented. The agent does the work and can show you where each setting lives, so you are never locked out of your own configuration. If you do not have a server yet, start here: Invoice Ninja on OpenSysLab.