> 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.

# Use case of display name in custom objects

> This use case explains the display name in custom objects and demonstrates how to create display names in the Zuora UI.

This use case explains the display name in custom objects and demonstrates how to create display names in the Zuora UI.

The display name can be used as a user-friendly name for a custom object linked to other custom objects.

For example, suppose that you have created two custom object definitions named "Vehicle" and "Tire Manufacturer" in your tenant. The Vehicle object contains a relationship-type field `Tire` linking to the Tire Manufacturer object. You can enable the display name for the Tire Manufacturer object by creating a text-type field `Manufacturer Name` . When creating custom object records for the Vehicle object, real manufacturer names can be recorded as values for the `Tire` field, instead of meaningless 36-character record IDs.

![Custom object relationship and display name](/_fern-img/cde49ec9f73d11663cee9a6dda5308704376f3701f21b2754c73ac356e836531.webp)

To create the display name, complete the following steps when creating or editing a custom object definition:

* Create a text-type custom field definition.
* Ensure none of the format checkboxes (UUID or URL) is selected.
* Select the **Display Name** checkbox.

Display names have the following limitations:

* Each custom object definition can have at most one field as the display name.
* Only text-type fields with no format (such as UUID or URL) can be used as display names.