> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Objects that support custom fields in Zuora

> This reference lists objects that supports custom fields, and also objects that support setting and retrieving custom field values via API operations.

This reference lists objects that supports custom fields, and also objects that support setting and retrieving custom field values via API operations.

## Objects that support creating custom fields from Zuora UI

Zuora enables you to create custom fields in the following objects from the Zuora UI:

* Orders objects:

  * Order
  * Order Action
  * Order Line Item
* Billing objects:

  * Account
  * Amendment
  * Contact
  * Subscription
  * Product
  * Feature
  * Price Book Item
  * Product Rate Plan
  * Product Rate Plan Charge
  * Subscription Rate Plan
  * Subscription Rate Plan Charge
  * Product Feature
  * Subscription Product Feature
  * Invoice Item Adjustment
  * Invoice Adjustment (This object is deprecated on Production)
  * Invoice
  * Invoice Item ("Invoice Detail")
  * Credit Memo
  * Debit Memo
  * Credit Memo Item
  * Debit Memo Item
  * Taxation Item ("Invoice Tax")
  * Credit Memo Taxation Item ("Credit Memo Tax")
  * Debit Memo Taxation Item ("Debit Memo Tax")
  * Usages
* Payments objects:

  * Refund
  * Payment
  * Payment Method
  * Credit Balance Adjustment
  * Payment Schedule
  * Payment Schedule Item
* Finance objects:

  * Accounting Period
  * Accounting Code
  * Revenue Schedule
  * Revenue Event
  * Journal Entry
  * Journal Entry Item
  * Revenue Event Item
  * Revenue Schedule Item

You can also set values to the custom fields in these objects.

Note that for the custom field defined in Zuora Billing that has revenue impact, after the object data has synced to Zuora Revenue, any update to the custom fields in Zuora Billing cannot be automatically interfaced to Zuora Revenue.

## Objects that support setting values to custom fields

After creating a custom field in the Zuora UI, you can set the value to this field using either UI or API. Setting values to custom fields is available to all the listed objects from the Zuora UI, but is restricted to only some objects via API.

The following table describes the mapping relationship between objects and the supported custom field operations via API:

| Object                                                       | Set value to custom fields via API | Retrieve value of custom fields via API |
| ------------------------------------------------------------ | ---------------------------------- | --------------------------------------- |
| Order                                                        | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Order Action                                                 | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Account                                                      | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Amendment                                                    | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Contact                                                      | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Contact Snapshot                                             |                                    | *(checkmark green icon)*                |
| Subscription                                                 | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Product                                                      | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Feature                                                      | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Price Book Item                                              |                                    |                                         |
| Product Rate Plan                                            | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Product Rate Plan Charge                                     | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Subscription Rate Plan                                       | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Subscription Rate Plan Charge                                | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Product Feature                                              |                                    | *(checkmark green icon)*                |
| Subscription Product Feature                                 |                                    | *(checkmark green icon)*                |
| Invoice Item Adjustment                                      | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Invoice Adjustment (This object is deprecated on Production) | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Invoice                                                      | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Invoice Item ("Invoice Detail")                              | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Credit Memo                                                  | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Debit Memo                                                   | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Credit Memo Item                                             | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Debit Memo Item                                              | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Taxation Item ("Invoice Tax")                                | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Credit Memo Taxation Item ("Credit Memo Tax")                |                                    | *(checkmark green icon)*                |
| Debit Memo Taxation Item ("Debit Memo Tax")                  |                                    | *(checkmark green icon)*                |
| Usage                                                        | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Refund                                                       | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Payment                                                      | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Credit Balance Adjustment                                    | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Payment Method                                               | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Accounting Period                                            | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Accounting Code                                              | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Revenue Schedule                                             | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Revenue Event                                                | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Journal Entry                                                | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Journal Entry Item                                           | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Revenue Event Item                                           | *(checkmark green icon)*           | *(checkmark green icon)*                |
| Revenue Schedule Item                                        | *(checkmark green icon)*           | *(checkmark green icon)*                |