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 #197: Frequently Asked Questions on GraphQL APIs

      🎊 Nearing 200th Kaizen Post – We want to hear from you! Do you have any questions, suggestions, or topics you would like us to cover in future posts? Your insights and suggestions help us shape future content and make this series better for everyone.
    • Kaizen #198: Using Client Script for Custom Validation in Blueprint

      Nearing 200th Kaizen Post – 1 More to the Big Two-Oh-Oh! Do you have any questions, suggestions, or topics you would like us to cover in future posts? Your insights and suggestions help us shape future content and make this series better for everyone.
    • Celebrating 200 posts of Kaizen! Share your ideas for the milestone post

      Hello Developers, We launched the Kaizen series in 2019 to share helpful content to support your Zoho CRM development journey. Staying true to its spirit—Kaizen Series: Continuous Improvement for Developer Experience—we've shared everything from FAQs
    • Kaizen #193: Creating different fields in Zoho CRM through API

      🎊 Nearing 200th Kaizen Post – We want to hear from you! Do you have any questions, suggestions, or topics you would like us to cover in future posts? Your insights and suggestions help us shape future content and make this series better for everyone.
    • Client Script | Update - Introducing Commands in Client Script!

      Have you ever wished you could trigger Client Script from contexts other than just the supported pages and events? Have you ever wanted to leverage the advantage of Client Script at your finger tip? Discover the power of Client Script - Commands! Commands