Attention API Users: Upcoming Support for Renaming System Fields

Attention API Users: Upcoming Support for Renaming System Fields


Hello all!
We are excited to announce an upcoming enhancement in Zoho CRM: support for renaming system-defined fields!

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
    • Sticky Posts

    • Kaizen #217 - Actions APIs : Tasks

      Welcome to another week of Kaizen! In last week's post we discussed Email Notifications APIs which act as the link between your Workflow automations and you. We have discussed how Zylker Cloud Services uses Email Notifications API in their custom dashboard.
    • Kaizen #216 - Actions APIs : Email Notifications

      Welcome to another week of Kaizen! For the last three weeks, we have been discussing Zylker's workflows. We successfully updated a dormant workflow, built a new one from the ground up and more. But our work is not finished—these automated processes are
    • Kaizen #152 - Client Script Support for the new Canvas Record Forms

      Hello everyone! Have you ever wanted to trigger actions on click of a canvas button, icon, or text mandatory forms in Create/Edit and Clone Pages? Have you ever wanted to control how elements behave on the new Canvas Record Forms? This can be achieved
    • Kaizen #142: How to Navigate to Another Page in Zoho CRM using Client Script

      Hello everyone! Welcome back to another exciting Kaizen post. In this post, let us see how you can you navigate to different Pages using Client Script. In this Kaizen post, Need to Navigate to different Pages Client Script ZDKs related to navigation A.
    • Kaizen #210 - Answering your Questions | Event Management System using ZDK CLI

      Hello Everyone, Welcome back to yet another post in the Kaizen Series! As you already may know, for the Kaizen #200 milestone, we asked for your feedback and many of you suggested topics for us to discuss. We have been writing on these topics over the