Skip to main content
The Invoice Custom Fields app automatically fills in custom fields on your Stripe invoices using metadata from invoices, customers, Checkout sessions, and static fallback values. At a high level:
  • you configure up to 4 field mapping rules in the app settings,
  • the app automatically syncs custom fields onto draft invoices,
  • you can also sync fields manually from the invoice detail page,
  • Payment Links with invoice creation enabled are kept in sync.

​
Who this app is for

This app is for teams that use Stripe Invoicing and need custom fields (like PO numbers, project codes, customer references, or cost centers) automatically populated on invoices.

​
How it works

Each field mapping rule defines:
  • a source key to look up in metadata (invoice, customer, or Checkout session),
  • a static fallback value used when no metadata is found,
  • a label that appears on the invoice header.
The app resolves values in priority order: invoice metadata, customer metadata, Checkout custom fields, then static fallback.

​
Data handling summary

  • Configuration is stored per Stripe account in our database.
  • The app reads invoice and customer metadata from Stripe to resolve field values.
  • No sensitive customer data is stored beyond operational references.
For exact details, see:

​
Continue

Install the app

Step-by-step install and first setup.

Configure field mappings

Set up your invoice custom field rules.

Use the app

Learn automatic sync, manual sync, and status behavior.

Troubleshooting

Fix common setup and sync issues quickly.