Current Behavior
Currently, system-defined fields returned by the GET - Fields Metadata API have display_label and field_label properties that cannot be renamed. These labels are static and predefined.
What's Changing?
You will soon be able to rename the display names of system-defined fields by editing the field_label property using the PATCH - Fields API or via the Zoho CRM UI. Once renamed, these updated labels will be reflected in the responses of all versions of the GET - Fields Metadata API.
Release plan
This update will be rolled out across all DCs from October 2025. We will share a follow-up announcement once the feature is live.
Action Required
If your integrations are hardcoded with values from the display_label or field_label properties of the GET - Fields Metadata API, please update them to use the api_name instead. The api_name is a permanent and unique identifier for each field and remains unaffected by label changes.
We strongly recommend reviewing your integrations and making the necessary changes well in advance of October 2025 to avoid any confusion or issues once the update goes live.
For any questions or assistance, feel free to reach out to the CRM support team at support@zohocrm.com
Thank you for your cooperation.
Zoho CRM Team