Customer organisation metadata
Attach custom key-value data to a customer organisation for internal reference and document templates.
Custom metadata lets you store extra information against a customer organisation. Use it for anything that doesn't fit the standard customer fields: ERP customer numbers, Shopify IDs, internal account codes, or any reference your team needs to track.
Metadata is managed from the customer detail page and can be included in document templates like invoices and estimates.
When to use it
| Use case | Example key | Example value |
|---|---|---|
| ERP customer ID | erp_customer_id | CUST-00412 |
| Shopify customer ID | shopify_id | 7291048302 |
| Internal account tier | account_tier | enterprise |
| Accounting contact ID | xero_contact_id | abc123-xyz |
| Requires purchase order | po_required | true |
Add a metadata entry
- Navigate to Customers from the main sidebar.
- Click the customer organisation you want to update.
- Scroll to the Metadata section on the customer's Overview page.
- Click the + icon in the Metadata section. The Add Metadata dialog opens.
- Enter a Key and a Value.
- Click Add Metadata.
Each key must be unique per organisation. If a key already exists, edit the existing entry rather than creating a new one.
Edit a metadata entry
- On the customer's Overview page, find the entry in the Metadata section.
- Click the ⋮ menu on the row and select Edit. The Edit Metadata dialog opens.
- Update the Key or Value.
- Click Save Changes.
Delete a metadata entry
- On the customer's Overview page, find the entry in the Metadata section.
- Click the ⋮ menu on the row and select Delete.
- Confirm the deletion in the Delete Metadata dialog.
Deleting an entry is permanent. Any document templates that reference the deleted key will simply leave that field blank.
Use metadata in document templates
Metadata values are available inside document templates, so you can include things like a customer's ERP number on their invoices or estimates.
Metadata is part of the CUSTOMER object that document templates receive. In the template editor, click Variables and, under Customer, insert metadata['KEY'], then replace KEY with your key, for example [(${CUSTOMER.metadata['erp_customer_id']})]. The panel does not list your own keys, so type the key yourself.
Part lines work the same way with the part specification's metadata: inside a parts loop, part.metadata['key'] works on every document type that has part lines. For a full guide to template variables, see the Template editor writing guide.
📋 This feature was introduced in the Pricing Gates, Organisation Metadata & Storefront Billing release.
Last updated on
Edit customer details
Add a new customer in Phasio and keep their organisation details up to date, including addresses, tax information and primary and secondary contacts.
Edit customer specific catalog
Add recurring parts with predefined manufacturing specifications to a customer's catalog in Phasio, so they can reorder them quickly in future quotes.