Platform
Updated 5 Aug 2026

Custom fields on your records

Add your own fields — 15 types across invoices, expenses, items, payments, clients and deals. Mark them required, validate with a pattern, and choose whether they show on the invoice PDF or the portal. They ride a stable api name into the report builder, the API and CSV exports.

Every business tracks something Finocket doesn't ship a box for — a PO number on invoices, a warranty date on items, a lead source on deals. Custom fields let you add exactly those, so your records hold the information you actually work with instead of forcing it into the notes.

Fifteen field types

Pick the right shape for what you're capturing: text, multi-line text, number, decimal, amount, percent, date, checkbox, dropdown, multi-select, URL, email, phone, auto-number (a running series like INV-0001, assigned for you), and lookup (a reference to a client or an item).

On the records that matter

Define fields for any of six record types — invoices, expenses, items, payments, clients and deals — from Profile → Custom fields. Each field appears on that record's form for everyone in the workspace.

Make them behave

Mark a field required so a record can't be saved without it, and add a validation pattern (a regex) to enforce a shape — a fixed-length code, a specific format. Two switches control where a field is seen: show on PDF puts it on the invoice document, and show on portal exposes it on the client or vendor portal. Leave both off and it's an internal-only field.

In reports, the API and CSV

A custom field rides a stable api name derived from its label, and that same name is used everywhere: it shows up automatically as a column and a filter in the report builder, comes back on the record in the API, and appears as a column in CSV exports. Define it once and it's available across all three.

Custom fields are an application-layer feature — the field definitions and their values live in your workspace's data. They shape and validate what you enter; they aren't a database-level access control.

Related: Report builder, Developers — API keys & webhooks.

Frequently asked questions

What kinds of custom fields can I add?

Fifteen types: text, multi-line text, number, decimal, amount, percent, date, checkbox, dropdown, multi-select, URL, email, phone, auto-number (a running series like INV-0001), and lookup (a reference to a client or an item).

Which records can carry custom fields?

Six: invoices, expenses, items, payments, clients and deals. Define a field for a record type under Profile → Custom fields and it appears on that record's form for the whole workspace.

Can I make a field mandatory or enforce a format?

Yes. Mark a field required so a record can't be saved without it, and add a validation pattern to enforce a shape — a fixed-length code, a specific format. Two switches also control visibility: show on PDF and show on portal.

Do custom fields show up in reports, the API and exports?

Yes — each field rides a stable api name, and that same name appears as a column and filter in the report builder, comes back on the record in the API, and appears as a column in CSV exports. Custom fields are an application-layer feature that shapes and validates what you enter, not a database-level access control.

Related articles

    Custom fields on your records · Finocket