> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upflow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Import and create custom fields into Upflow

> Add custom fields to customers, invoices, payments and credit notes in Upflow to filter, segment and report on data not synced from your source system.

Filter your data, break down your widgets or segment, and intervene on your objects based on information our integrations do not natively pull from your source solutions: custom fields. Import them into your organization and tag your customers, payments, invoices, and credit notes for an improved experience!

# Availability and management

❗Only customer custom fields can be imported from your source system and your CRM.
Only NetSuite, QuickBooks, and Stripe Billing allow a sync at the invoice level.
An API connection also allows you to update your invoices.

| Source         | Clients                    | Invoices                                 | Credit notes & payments                                                            |
| -------------- | -------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------- |
| In-app         | ✅                          | ✅                                        | ✅                                                                                  |
| API            | ✅                          | ✅                                        | ❌                                                                                  |
| Chargebee      | ✅                          | ❌                                        | ❌                                                                                  |
| NetSuite       | ✅                          | ✅                                        | ✅ (**custom** fields only)                                                         |
| Pennylane      | ❌ (**Native** fields only) | ❌                                        | ❌                                                                                  |
| Sage Intacct   | ❌                          | ❌                                        | ❌                                                                                  |
| Stripe billing | ✅                          | ✅ (**custom** fields only, **Metadata**) | ✅ (**payment** **custom** fields only, **Metadata**)  ❌ Credit notes not supported |
| Salesforce     | ✅                          | ❌                                        | ❌                                                                                  |
| Sellsy         | ✅                          | ❌                                        | ❌                                                                                  |
| QuickBooks     | ❌ (**Native** fields only) | ✅ **Custom** fields only                 | ❌                                                                                  |
| Xero           | ✅                          | ❌                                        | ❌                                                                                  |
| Zuora          | ✅                          | ✅                                        | ❌                                                                                  |

In the **Customer fields** tab of your **Settings**, click on **Add field** and search for an existing custom field.

<img src="https://mintcdn.com/upflow-04dc27cd/AfdrXycJno4XMWAU/images/45488114460177.png?fit=max&auto=format&n=AfdrXycJno4XMWAU&q=85&s=a1110d01eec165ea4cb6dd9497bcdadc" width="288" alt="Customer fields tab in Settings" data-path="images/45488114460177.png" />

<img src="https://mintcdn.com/upflow-04dc27cd/AfdrXycJno4XMWAU/images/45488114462225.png?fit=max&auto=format&n=AfdrXycJno4XMWAU&q=85&s=2d4e5ebbc0b226b40601e79ae58b0a4c" width="493" alt="Add field search dialog" data-path="images/45488114462225.png" />

​

## Create a custom field in Upflow

If you need a field that isn't available or supported in your source of truth, you can create it manually in Upflow.

From the same section, scroll down to the end of the available list, and click *Add custom field*:

<img src="https://mintcdn.com/upflow-04dc27cd/AfdrXycJno4XMWAU/images/45488098081041.png?fit=max&auto=format&n=AfdrXycJno4XMWAU&q=85&s=27b68cb34bbc40bd1e4858ef34ca4ee6" alt="" width="320" data-path="images/45488098081041.png" />

Name it, and select the type you wish to use:

<img src="https://mintcdn.com/upflow-04dc27cd/AfdrXycJno4XMWAU/images/45488114467217.png?fit=max&auto=format&n=AfdrXycJno4XMWAU&q=85&s=26053c63d6a4af7c2baefca50772209d" alt="" width="396" data-path="images/45488114467217.png" />

Don't forget to click Save at the bottom of the page!

From the same section, you can:

* Remove your custom fields (click on the cross next to their name)
* Edit those created on Upflow (rename and update their values)

Don’t forget to save!

❗ You cannot push custom fields from Upflow to your source solution. Confirm they exist there before searching!

❗️Custom fields can't be updated via CSV, only manually or via API.

## Special use cases

If your field is not available in the dropdown list as shown above, you may have the following option for certain integrations, such as Chargebee or Stripe Billing:

* Click "Add field" at the customer level (or invoice level for Stripe);
* Scroll down if needed, and click "Add custom field";
  <img src="https://mintcdn.com/upflow-04dc27cd/AfdrXycJno4XMWAU/images/45488114471697.png?fit=max&auto=format&n=AfdrXycJno4XMWAU&q=85&s=57eacc77c4839f915fceecedd3cbc6d8" alt="" width="320" data-path="images/45488114471697.png" />
* Click the option "Yes, in Chargebee" or "Yes, in Stripe Billing":
  <img src="https://mintcdn.com/upflow-04dc27cd/AfdrXycJno4XMWAU/images/45488114475025.png?fit=max&auto=format&n=AfdrXycJno4XMWAU&q=85&s=c88d4ed01524da7b0621a1d748f83cb3" alt="" width="320" data-path="images/45488114475025.png" />
* Then add the API or Metadata name displayed in Chargebee or Stripe:
  <img src="https://mintcdn.com/upflow-04dc27cd/AfdrXycJno4XMWAU/images/45488114476049.png?fit=max&auto=format&n=AfdrXycJno4XMWAU&q=85&s=39a2c12953150959c3950e00196135b5" alt="" width="320" data-path="images/45488114476049.png" />
* For example:
  * if your Stripe metadata key is billing\_method, enter exactly **billing\_method**
  * in Chargebee, the API name will start with cf\_ which you will need to include in Upflow
* Click "Add", and don't forget to save at the bottom of the page.

Give it a few minutes to a few hours for the data to sync into Upflow, based on the data volume.

## Edit custom field values

If your custom field is synced from your billing system or Salesforce, they must be edited there directly and won't be editable in Upflow.

If your custom field was created in the Upflow UI, you can edit it at the item level (customer, invoice, credit note, etc.) or in bulk from the list view.

❗ You can only update the values of those created in-app, the others being pulled from your source system. ❗️Custom fields can't be updated via CSV, only manually or via [API](https://developer.upflow.io/#tag/custom-fields).

## Usage

Your custom fields are now available. Review them in the dedicated sections of your:

* Customers details
* Invoices details
* Credit notes details
* Payments details

You can additionally make them filterable columns of their respective lists and use them to filter or break down your Analytics dashboards and widgets.

​
​
