Kaizen #27 - Layouts in Zoho CRM

Kaizen #27 - Layouts in Zoho CRM

Hello everyone!
Welcome back to another week of Kaizen!
In this post, we will discuss the Layouts in Zoho CRM.

1. What are Layouts?

Layouts allow you to organize various fields of a module into sections. They also allow you to set layout-specific properties such as mandatory, unique, default, etc, to various fields. Every module has a default layout named "Standard". You can also create your own layouts for each module.

2. Adding a new layout to a module

  • Go to Setup > Customization > Modules and Fields.
  • Choose module > New Layout.
  • If the new layout is the first custom layout of that module, a cloned version of the standard layout will be loaded, in which you can make the desired changes. If you already have a custom layout, you can choose which layout would you like to clone, and make updates to that layout. 
  • Click More options > Remove Field to delete any unwanted field. 
    Note: You cannot modify the properties of system-defined fields in any layout of any module. You can find the system-defined fields for each module in the next section.

  • To add new fields, drag and drop the field type and set the field properties.
  • Click More options > Edit Properties to modify the properties of a field. The Set Permission option allows you to manage access permission for the field. The Mark as required option allows you to make a field's input mandatory. 
  • After making all the changes, click Save.
  • Select the profiles you want to assign the layout permission to and click Save.
You can get the details of a layout such as the ID, available sections, the visibility of the layout etc., via the Layouts Metadata API. Alternatively, you can go to Setup > Customization > Modules and Fields > Choose module > Choose layout to see the layout ID in the URL. 
            
3. System-defined fields of the default modules

As we discussed in the previous section, you cannot modify the properties of system-defined fields in any layout of a module. Listed below are the system-defined fields of the default modules in Zoho CRM.

Module
System-defined mandatory fields and field type
Leads
Last Name - Single Line
Contacts
Last Name - Single Line
Accounts
Account Name - Single Line
Deals
Deal Name - Single Line
Stage - Picklist
Tasks
Subject - Multi Line
Calls
Subject - Multi LIne
Call Type - Picklist
Call Start Time - Date/Time
Call Duration - Single Line
Events
Title - Single Line
From - Date/Time
To - Date/Time
Products
Product Name - Single Line
Quotes
Subject - Single Line
Product Details - Product Line Item
Invoices
Subject - Single Line
Product Details - Product Line Item
Campaigns
Campaign Name - Single Line
Vendors
Vendor Name - Single Line
Price Books
Price Book Name - Single Line
Pricing Details
Cases
Case Origin - Picklist
Status - Picklist
Subject - Single Line
Solutions
Solution Title - Single Line
Purchase Orders
Subject - Single Line
Vendor Name - Lookup
Product Details - Product Line Item
Sales Orders
Subject - Single Line
Product Details - Product Line Item

4. Inserting Records in a Particular Layout

a. Via API

Before we look at how to insert a record in a particular layout via API, let us have a look at what happens when you specify and do not specify the layout details in the input. 

When you specify layout details in the input:
1. The system checks for both system-defined and user-defined mandatory fields. 
2. The default values for fields with default values will be auto-populated. 

When you do not specify layout details in the input:

1. The system inserts the record in the "standard" layout of that module.  
2. The system checks only for system-defined mandatory fields. 
3. The default values for fields with default values will not be auto-populated.

Specify the unique layout ID in the input in the form of a JSON object named "Layout". The "id" key in the response of the layouts metadata API represents the unique ID of the layout.

Input

{
    "data": [
        {
            "Company": "Zylker",
            "Last_Name": "Daly",
            "First_Name": "Paul",
            "Email": "p.daly@zylker.com",
            "State": "Texas",
            "Layout": {
  "id": "4150868000000244014"
            }
        },
        {
            "Company": "Villa Margarita",
            "Last_Name": "Dolan",
            "First_Name": "Brian",
            "Email": "brian@villa.com",
            "State": "Texas"
        }
    ]
}




To know more, refer to the insert records API.

Note:
  • A single record cannot be added to multiple layouts. In this case, you must create a new record with the same details in the desired layout. A single record (with a unique record ID) cannot exist in more than one layout. 
b. Via UI
To insert records in a particular module via UI, choose the layout before you insert a record in a module.




Note:
The Get Records API lists all the records from all the layouts. The key "layout" gives the details of the layout that the record belongs to.

5. Updating the layout details for a record via API

To update the layout details of a record via API, specify the layout details in the input. When you update the layout details of a record:
  • The system checks for both system-defined and user-defined mandatory fields in the layout that you update. For instance, if you update the layout of a lead from standard to custom, where "Company" is a mandatory field, then the lead must already have a value in the "Company" field, or you must specify it in the input. The system checks for both "Last_Name" (system-defined mandatory field) and "Company" (user-defined mandatory field) before updating the layout of the record. 
  • The system auto-populates the fields with their default values (if applicable) in the layout that you update.

We hope you found this post useful. Please reach out to us at support@zohocrm.com if you have questions, or let us know in the comment section.

Cheers!





    Access your files securely from anywhere







                          Zoho Developer Community






                                                • Desk Community Learning Series


                                                • Digest


                                                • Functions


                                                • Meetups


                                                • Kbase


                                                • Resources


                                                • Glossary


                                                • Desk Marketplace


                                                • MVP Corner


                                                • Word of the Day


                                                • Ask the Experts



                                                          • 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


                                                          Manage your brands on social media



                                                                Zoho TeamInbox Resources



                                                                    Zoho CRM Plus Resources

                                                                      Zoho Books Resources


                                                                        Zoho Subscriptions Resources

                                                                          Zoho Projects Resources


                                                                            Zoho Sprints Resources


                                                                              Qntrl Resources


                                                                                Zoho Creator Resources



                                                                                    Zoho CRM Resources

                                                                                    • CRM Community Learning Series

                                                                                      CRM Community Learning Series


                                                                                    • Kaizen

                                                                                      Kaizen

                                                                                    • Functions

                                                                                      Functions

                                                                                    • Meetups

                                                                                      Meetups

                                                                                    • Kbase

                                                                                      Kbase

                                                                                    • Resources

                                                                                      Resources

                                                                                    • Digest

                                                                                      Digest

                                                                                    • CRM Marketplace

                                                                                      CRM Marketplace

                                                                                    • MVP Corner

                                                                                      MVP Corner







                                                                                        Design. Discuss. Deliver.

                                                                                        Create visually engaging stories with Zoho Show.

                                                                                        Get Started Now


                                                                                          Zoho Show Resources


                                                                                            Zoho Writer Writer

                                                                                            Get Started. Write Away!

                                                                                            Writer is a powerful online word processor, designed for collaborative work.

                                                                                              Zoho CRM コンテンツ





                                                                                                Nederlandse Hulpbronnen


                                                                                                    ご検討中の方




                                                                                                          • Recent Topics

                                                                                                          • Introducing the revamped What's New page

                                                                                                            Hello everyone! We're happy to announce that Zoho Campaigns' What's New page has undergone a complete revamp. We've bid the old page adieu after a long time and have introduced a new, sleeker-looking page. Without further ado, let's dive into the main
                                                                                                          • Prevent stripping of custom CSS when creating an email template?

                                                                                                            Anyone have a workaround for this? Zoho really needs to hire new designers - templates are terrible. A custom template has been created, but every time we try to use it, it strips out all the CSS from the head.  IE, we'll define the styles right in the <head> (simple example below) and everything gets stripped (initially, it saves fine, but when you browse away and come back to the template, all the custom css is removed). <style type="text/css"> .footerContent a{display:block !important;} </style>
                                                                                                          • Bulk Moving Images into Folders in the Library

                                                                                                            I can't seem to select multiple images to move into a folder in order to clean up my image library and organize it. Instead, I have to move each individual image into the folder and sometimes it takes MULTIPLE tries to get it to go in there. Am I missing
                                                                                                          • Zoho Campaigns - Why do contacts have owners?

                                                                                                            When searching for contacts in Zoho Campaigns I am sometimes caught out when I don't select the filter option "Inactive users". So it appears that I have some contacts missing, until I realise that I need to select that option. Campaigns Support have
                                                                                                          • Latest updates in Zoho Meeting | Breakout rooms and End to end encryption

                                                                                                            Hello everyone, We’re excited to share a few updates for Zoho Meeting. Here's what we've been working on lately: Introducing Breakout Rooms for enhanced collaboration in your online meetings and End-to-end encryption to ensure that the data is encrypted
                                                                                                          • Systematic SPF alignment issues with Zoho subdomains

                                                                                                            Analysis Period: August 19 - September 1, 2025 PROBLEM SUMMARY Multiple Zoho services are causing systematic SPF authentication failures in DMARC reports from major email providers (Google, Microsoft, Zoho). While emails are successfully delivered due
                                                                                                          • Accidentally deleted a meeting recording -- can it be recovered?

                                                                                                            Hi, I accidentally deleted the recording for a meeting I had today. Is there a way I can recover it?
                                                                                                          • Cross References Do Not Update Correctly

                                                                                                            I am using cross references to reference Figures and current am just using the label and number, i.e. Figure #. As seen here: When I need to update the field, I use the update field button. But it will change the cross reference to no longer only including
                                                                                                          • Citation Problem

                                                                                                            I had an previous ticket (#116148702) on this subject. The basic problem is this; the "Fetch Details" feature works fine on the first attempt but fails on every subsequent attempt, Back in July after having submitted information electronically and was
                                                                                                          • To Zoho customers and partners: how do you use Linked Workspaces?

                                                                                                            Hello, I'm exploring how we can set up and use Linked Workspaces and would like to hear from customers and partners about your use cases and experience with them. I have a Zoho ticket open, because my workspace creation fails. In the meantime, how is
                                                                                                          • How to access email templates using Desk API?

                                                                                                            Trying to send an email to the customer associated to the ticket for an after hours notification and can't find the API endpoint to grab the email template. Found an example stating it should be: "https://desk.zoho.com/api/v1/emailtemplates/" + templateID;
                                                                                                          • How to render either thumbnail_url or preview_url or preview_data_url

                                                                                                            I get 401 Unauthorised when using these urls in the <img> tag src attribute. Guide me on how to use them!
                                                                                                          • Update Portal User Name using Deluge?

                                                                                                            Hey everyone. I have a basic intake form that gathers some general information. Our team then has a consultation with the person. If the person wants to move forward, the team pushes a CRM button that adds the user to a creator portal. That process is
                                                                                                          • Create new Account with contact

                                                                                                            Hi I can create a new Account and, as part of that process, add a primary contact (First name, last name) and Email. But THIS contact does NOT appear in Contacts. How can I make sure the Contact added when creating an Account is also listed as a Contact?
                                                                                                          • Flow Task Limits - How to Monitor, Understand Consumption?

                                                                                                            So, I got an email last night saying that I've exhausted 70% of my tasks for this month, and encouraging me to buy more tasks. I started to dig into this, and I cannot for the life of me figure out where to find any useful information for understanding,
                                                                                                          • Unable to retrieve Contact_Name field contents using Web API in javascript function

                                                                                                            Hello, I've added a field in the Purchase Order form to select and associate a Sales Order (Orden_de_venta, lookup field). I've also created a client script to complete some fields from the Sales Order (and the Quote), when the user specifies the related
                                                                                                          • Updating Woocommerce Variation Products Prices Via Zoho CRM

                                                                                                            I can update product prices with this flow: But I can't update variant products. I got a code from Zoho for this, but I couldn't get it to work. It needs to find the product in the CRM from the SKU field and update the variation with the price there.
                                                                                                          • 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
                                                                                                          • Placing a condition before converting the LEAD

                                                                                                            Hi,  I need some assistance with Lead conversion. I need to place certain conditions before allowing the user to convert the lead.  For example: up until the certain status's doesn't equal "green" don't allow to convert lead.  I tried creating this using
                                                                                                          • Zoho CRM Calendar | Custom Buttons

                                                                                                            I'm working with my sales team to make our scheduling process easier for our team. We primary rely on Zoho CRM calendar to organize our events for our sales team. I was wondering if there is a way to add custom button in the Calendar view on events/meeting
                                                                                                          • Power of Automation:: Automate the process of updating project status based on a specific task status.

                                                                                                            Hello Everyone, Today, I am pleased to showcase the capabilities of a custom function that is available in our Gallery. To explore the custom functions within the Gallery, please follow the steps below. Click Setup in the top right corner > Developer
                                                                                                          • Emails Disappearing From Inbox

                                                                                                            I am experiencing the unnerving problem of having some of the messages in my inbox just disappear.  It seems to happen to messages that have been in there for longer than a certain amount of time (not sure how long exactly). They are usually messages that I have flagged and know I need to act on, but have not gotten around to doing so yet.  I leave them in my inbox so I will see them and be reminded that I still need to do something about them, but at least twice now I have opened my inbox and found
                                                                                                          • BUTTONS SHOWN AS AN ICON ON A REPORT

                                                                                                            Hi Is there any way to create an action button but show it as an icon on a report please? As per the attached example? So if the user clicks the icon, it triggers an action?
                                                                                                          • Power of Automation :: Automatic removal of project users once the project status is changed.

                                                                                                            A custom function is a software code that can be used to automate a process and this allows you to automate a notification, call a webhook, or perform logic immediately after a workflow rule is triggered. This feature helps to automate complex tasks and
                                                                                                          • Customizing Form Questions per Recipient Group in Zoho Campaigns/Forms

                                                                                                            Hello everyone, I would like to ask if it’s possible in Zoho Campaigns or Zoho Forms to send out a campaign where the form questions can be customized based on the group of recipients. Use case example: I have prepared 20 questionnaire questions. For
                                                                                                          • Zoho Books - France

                                                                                                            L’équipe de Zoho France reçoit régulièrement des questions sur la conformité de ses applications de finances (Zoho Books/ Zoho Invoice) pour le marché français. Voici quelques points pour clarifier la question : Zoho Books est un logiciel de comptabilité
                                                                                                          • in zoho creator Sales Returns form has sub form Line Items return quantity when i upate the or enter any values in the sub form that want to reflect in the Sales Order form item deail sub form field Q

                                                                                                            in zoho creator Sales Returns form has sub form Line Items return quantity when i upate the or enter any values in the sub form that want to reflect in the Sales Order form item deail sub form field Quantity Returned\ pls check the recording fetch_salesorder
                                                                                                          • Client Script Payload Size Bug

                                                                                                            var createParams = { "data": [{ "Name": "PS for PR 4050082000024714556", "Price_Request": { "id": "4050082000024714556" }, "Account": { "id": "4050082000021345001" }, "Deal": { "id": "4050082000023972001" }, "Owner": { "id": "4050082000007223004" }, "Approval_Status":
                                                                                                          • Edit Permission during and after approval?

                                                                                                            When a record is sent for approval Can a user request for edit permission from the approver? We don't want to give edit permissions for all the records under approval Only on a case-by-case basis How can we achieve this?
                                                                                                          • Forms - Notification When Response Submitted

                                                                                                            How do I set it up to generate an email notification when a response (class request) is submitted?
                                                                                                          • how to use validation rules in subform

                                                                                                            Is it possible to use validation rules for subforms? I tried the following code: entityMap = crmAPIRequest.toMap().get("record"); sum = 0; direct_billing = entityMap.get("direct_billing_details"); response = Map(); for each i in direct_billing { if(i.get("type")
                                                                                                          • Notes Issues

                                                                                                            Been having issues with Notes in the CRM. Yesterday it wasn't showing the notes, but it got resolved after a few minutes., Now I have been having a hard time saving notes the whole day. Notes can't be saved by the save button. it's grayed out or not grayed
                                                                                                          • How to disable user entry on Answer Bot in Zobot

                                                                                                            Hi, I have an Answer Bot in my Zobot, here is the configuration: I only want the user to choose 1 of the 4 the options I have provided: When no answer found, user chooses 'I'll rephrase the question' or 'Ask a different question When answer is found,
                                                                                                          • More admin control over user profiles

                                                                                                            It's important for our company, and I'm sure many others, to keep our users inline with our branding and professional appearance. It would be useful for administrators to have more control over profile aspects such as: Profile image User names Email signatures
                                                                                                          • Please Make Zoho CRM Cadences Flexible: Allow Inserting and Reordering Follow-Up Steps

                                                                                                            Sales processes are not static. We test, learn, and adapt as customers respond differently than expected. Right now, Zoho Cadences do not support inserting a new step between existing follow-ups or changing the type of an existing primary step. If I realize
                                                                                                          • Changing the Default Search Criteria for Finding Duplicates

                                                                                                            Hey everyone, is it possible to adjust the default search criteria for finding and merging duplicate records? Right now, CRM uses some (in my opinion nonsensical) fields as search criteria for duplicate records which do nothing except dilute the results.
                                                                                                          • Clear Tag & Linking Between Quotes and Sales Orders

                                                                                                            Hi Zoho Team, In Zoho Books, when a quote is converted into a sales order, it would be extremely useful to have: A clear tag/indicator on the quote showing that it has been converted into a sales order. A direct link in the sales order back to the originating
                                                                                                          • How to Track and Manage Schedule Changes in Zoho Projects

                                                                                                            Keeping projects on track requires meticulous planning. However, unforeseen circumstances can cause changes to schedules, leading to delays. It becomes important to capture the reason for such changes to avoid them in the future. Zoho Projects acknowledges
                                                                                                          • Zoho Books Sandbox environment

                                                                                                            Hello. Is there a free sandbox environment for the developers using Zoho Books API? I am working on the Zoho Books add-on and currently not ready to buy a premium service - maybe later when my add-on will start to bring money. Right now I just need a
                                                                                                          • Add Direct Ticket Link to Zoho Help Center Portal in Email Replies

                                                                                                            Hi Zoho Support Team, We hope you're doing well. We’d like to request a small but valuable improvement to enhance the usability of the Zoho Help Center portal (https://help.zoho.com/portal/en/myarea). Currently, when someone from Zoho replies to a support
                                                                                                          • Next Page