Manage custom fields with the Object Manager

Supported objects

Currently, the object manager supports the following standard objects:

• Account
• Credit Memo
• Debit Memo
• Invoice
• Payment
• Product
• Product Rate Plan
• Product Rate Plan Charge
• Refund
• Subscription
• Subscription Rate Plan
• Subscription Rate Plan Charge
• Usage

If you need to manage custom fields for other standard objects, see Manage custom fields.

The following table describes the differences between managing custom fields with or without the Object Manager:

View custom fields

To view the custom fields that are defined for a standard object, perform the following steps:

1. Navigate to Platform > Object Manager in the left navigation menu.

2. On the Object Manager page, click the Standard Objects tab.
   Zuora lists standard objects that support custom fields with the number of existing custom fields of each object on this page.

3. Click the object name or the Edit icon  to open the detailed page of a particular object.

Zuora lists the custom fields that have been defined for the object in the Custom Fields tab.

False in the Legacy column indicates the custom field is defined with the Object Manager. Otherwise, this is a legacy custom field. For more information about limitations that apply only to custom fields defined with the Object Manager, see Notes and limitations.

Create custom fields

To define a custom field for a standard object, perform the following steps:

1. Open the detail page of the object you want to create custom fields for in Object Manager. For more information see View custom fields.

2. In the Custom Fields tab, click the Create icon . The Add New Custom Field window opens.

3. Enter the information of the custom field: 

   • Name: The custom field name displayed on UI.

   • API Name: The API name of the custom field. The value must end with __c (two underscores and the letter "c") and cannot be edited once created.

   • Description: (Optional) The description of the custom field.

   • Detail: Specify field type and settings. For more information about supported field types, settings, and limitations, see Custom field types and settings.

4. Click Save & Close to create the custom field and close the window.
   Alternatively, you can click Save & Add Another to create the custom field and add another one by repeating steps 3 and 4.

Zuora creates the custom field. The custom field will then appear in the Zuora UI. For example:

This means that if you define a custom field, then immediately perform a ZOQL query such as select BetaTester__c from Account, the query will not return any values for BetaTester__c.

To apply the default value to an existing object, you must modify the object via the Zuora UI or the Zuora API.

Modify custom fields

To modify the definition of a custom field, perform the following steps:

1. Open the object detail page that contains the custom field you want to modify in Object Manager. For more information see View custom fields. 

2. Locate the custom field you want to modify and then click the Edit icon . The Edit Custom Field window opens.

3. Modify the field definition.
   You cannot change the API name or field type.
   If the field is defined with the Object Manager, you can update the Indexed setting. For example, update the field from indexed to non-indexed or vice versa.

4. Click Save.

If you modify or delete a custom field, you must update any integrations that access the field. For example:

• If you change the label of a field, the API name of the field will also change. Any integration that continues to use the old API name will receive an error. You must update integrations to use the new API name.
• If you decrease the length of a field, any integration that sends data that exceeds the new field length will receive an "Invalid_value" error. You must check the maximum length of data that integrations could send.

Delete custom fields

To delete the definition of a custom field, perform the following steps:

1. Open the object detail page that contains the custom field you want to delete. For more information see View custom fields.
2. Locate the custom field you want to delete and then click the Delete icon .
3. In the confirmation dialog, click Delete.
   Note that you cannot edit the custom field while deletion is in progress. The label and API name of the custom field are displayed in gray during the deletion. The deletion time varies based on the data volume of this field in your Zuora tenant. For example, deleting a custom field with 10 million records might take more than two hours.

When the deletion is completed, this custom field will be removed from the list after reloading the page.

Notes and limitations

• The Required option is not available when defining custom fields for the following objects:
  • Amendments
  • Subscription Rate Plans
• For the Usage object, do not create a custom field with the same name as a standard Zuora field. This avoids ambiguity when importing usage files.
• Custom fields defined with the Object Manager are not available for Zuora 360 and 360+. For more information, see Synchronize Data from Zuora through Zuora 360 and Work with Zuora 360+.
• Custom fields defined with the Object Manager are not available for Zuora Warehouse.
• Tax apps will support custom fields defined with the Object Manager in later releases.
• Custom fields created via the Object Manager are not visible on the following settings pages:
  • Settings > Billing > Manage Custom Fields
  • Settings > Payments > Manage Custom Fields
  • Settings > Finance > Manage Custom Fields
  These pages will be deprecated soon.