Create Custom Layout | Zoho Creator Help

Create Custom Layout

1. What Does This Page Cover?

Learn to design a custom layout corresponding to your business requirements for the detailed view of your records using the Canvas layout builder. 

Before moving ahead, you can learn more about canvas layout builder and its the wide range of customization options.

2. Availability

  1. This help page is for users in Creator 5 and 6. Know your Creator version.
  2. Canvas can be accessed in both the free and paid plans of Creator, and is available across all the data centers.
  3. Only the super admin, admins, and developers can design custom layouts using Canvas, while other users can access and view them with relevant permissions.
  4. Canvas is supported only in web browsers i.e., you can design and view custom layouts for detail view of records in web browsers.

3. Desiging custom layouts

3.1 Custom Layout Creation Flow

3.2 See How To Configure

3.3 Steps to create a custom layout for detail view:

Note: You cannot create an application sandbox if there are canvas layouts in the same application. Learn more about creating a sandbox.
1. Navigate to the Design page of the report.
2. Select the Detail View tab.
3. Click the Create New Layout button beneath Custom Layout. You can select one of the following:
  1. Click From Scratch to create a new custom layout.
  2. Click From a Template to select and use a pre-designed template. Select a template of your choice and click the Use this Template button.
  3. Click Import JSON to import the custom layout that you had already created and exported. 
4. The Canvas layout builder will appear. 

5. From the top menu bar, you can do the following:
  1. Undo or redo changes.
  2. Preview the canvas before saving.
  3. Export the canvas in .json format.
  4. View the canvas in full screen.
  5. Name the canvas.

6. Click the Save button to save the changes made in your layout, since changes will not be saved automatically.

7. Drag and drop record data and elements from the Data and Elements modules respectively. 
8. Apply styles to the added data and elements in the custom layout.
9. Save and close the layout builder. The created custom layout will be added to the layouts section in detail view.
When you access the application, the detail view of your report will be displayed in this chosen custom layout.

3.3.1 Data module

  1. When you drag and drop fields into the Canvas layout builder, the default field value will be populated (in preview) with the first record's value in your report.

  2. If your report doesn't contain any record, then the corresponding field values will be displayed as "NA" in the above case. The same applies to pre-designed layout templates.
  1. In the Data module on the left, drag and drop the required fields (form and system fields) in the design area.
  2. Drag and drop the required fields, custom actions, record comments, blueprints, and related blocks onto the design area.
When you drag and drop related blocks, you can view them in different layouts as below. If your related blocks contain images, you can choose from two additional layouts for the blocks (template 3 and 4).

When you drag and drop the above components and click the Style tab, you can either apply application based themes or use the style options provided inside our layout builder. You can:
  1. Right-click on the label/value to change the field, hide the label, move the label to the left or top, make the component fixed or fluid, copy the style or paste from another style, and delete the field.

  2. Right-click on the button (custom action) to edit the action, change field, copy the style or paste from another style, or delete the action. 

  3. Right-click on the record comment to change the related list, copy the style or paste from another style, or lock and delete the comment. 

3.3.2 Elements module

You can move elements forward or backward by using the Depth option under Style.
Drag and drop the following elements from the menu on the left onto the design area.
  1. Section
  2. Tab
  3. Table
  4. Text
  5. Icon
  6. Line Section

The section element enables you to create standalone sections and group related content, such as fields, record comments, and blueprints. For example, you can either insert fields from the Data module onto a section or insert images of places, locations, or use it as a banner to display some message etc.

You can perform the following actions for the section element.
  1. Drag the borders to resize the section box.
  2. Click the We were unable to process some of the images.  icon to clone the section.
  3. You can right-click on the section and click insert to add fields, make the component fixed or fluid, copy the style, paste the style, or delete it.
  4. Add the required style for the elements. Tab

Tabs enable you to reorganize your data into distinct tabs. This helps to provide a well-organized display to users. For example, in the image below, the tab named Education Details is placed in the Employee Details module which has three tabs: Dependants, Salary Details, and Work Experience all within a section. By clicking the + icon you can add more tabs.

You can perform the following actions for the tab element.
  1. To name your tab, click the required tab -> open the Style tab in the left panel -> enter a suitable name.

  2. You can click the + icon to add more tabs.
  3. Name the tab by clicking on it and entering the tab name in the text bar. 
  4. Hover on the tabs and click the close icon to delete a tab.
  5. To rearrange tabs, hover on a tab until you get the double-sided arrow icon, and then drag and drop the tab to change its position.
  6. Right-click inside the tab to insert fields, make the component fixed or fluid, copy and paste a style, lock it, delete it, and more. 
  7. You can represent the tabs using icons. To do so, right-click on the tab name and click Show Icon to view and select the icons. 
  8. Once the icon is added, right-click to Hide or change the icon and Hide the tab name.

  9. You can also apply style components like images, background color, and more. Learn how Table

The table element can be used to display your record values in a tabular format. This format lets you save space in the detail view by displaying the data in a table structure, comprised of rows and columns. For example, in the image below, the product name, description, and product ID are the form fields present that are displayed as rows and columns. 

You can perform the following actions for the tab element.

  1. Hover on rows and columns and click the + or - icons to add or delete a row or column.
  2. Right-click on a row to change fields, make a component fixed or fluid, copy and paste a style, or delete the field.

  3. Drag the borders to resize the table. Text

You can insert a text box element to enter the required content within the detail view. For example, you can use the text element to display a heading before starting sections or to add a note or disclaimer.

  1. Drag the borders to resize the text box.
  2. Right-click to clone, make a component fixed or fluid, or delete the text box.

  3. Change text format to heading, bold, or normal, and also apply the required style options. Icon

You can use the icon element to represent a field instead of a conventional text label inside sections, tabs, tables, and so on. For example, in the image below the product, name and price are displayed using icons instead of text.

You can perform the following actions for the icon element.
  1. Scroll on the icon bar to move up and down and choose from the wide range of icons.

  2. Click on the icon to clone, delete or change it.

  3. Drag the borders to increase or decrease the size. Line

The line element can be used to insert a horizontal line to separate content or define a change in it. This element is used to represent a thematic break between content. For example, you can insert a line element between two sections in your layout. 
  1. You can set the line to horizontal or vertical, and adjust its thickness, style, and color.
  2. Click on the line to clone, set it as fixed component or delete it.

3.3.3 Style module

You can apply style from a myriad of options, such as background color, padding, field label alignment, border, and margin, to all components in the data and elements module. You can also customize the layout background by using the available style options.

Apart from the existing style options for applying colors, you can also apply the theme color used across your application to the layout and its elements. To do so, you can select the theme color option in the color picker and choose a suitable theme color variation if required.

By default, if you create a custom layout from scratch, your application's theme color will be applied to phone number fields, email fields, tab names, URLs, and so on.

  1. Certain style options are specific to an element. 
  2. You can reuse styles applied to components in the Data and Elements module. For example, the option to copy the style of a custom action button can be found under the right-click option. You can choose the Copy Style option and apply to the target element by right-clicking on it and choosing the Paste Style option.
  3. You can dynamically resize your custom layout based on your users' screen resolutions. For this, you need to select the component and check the Auto box next to height and width option.
  1. Apply style to layout
  2. Apply style to fields
  3. Apply style to custom functionalities
  4. Apply style to sections
  5. Apply style to tabs
  6. Apply style to table, text, icons, and line Style options for layout

You can customize the following aspects of your custom layout.
  1. Background
  2. Padding
  3. Height
  4. Width
  5. Fit to screen   


  1. Select a background color either by specifying the HEX code of the color or color picker. You can also choose from variations if your app's theme color is in the color picker.
  2. Tick the Image checkbox and enter the URL of the image you want to add.

    1. Image Size - The image size can be defined using three options:
      1. Contain - Adjust the size of an image to fit into a page, while keeping the aspect-ratio intact.
      2. Original - Retain the image in its original size.
      3. Cover - Stretch the image to fill the length and width of the layout page regardless of the aspect-ratio.
    2. Image Repeat - If the size of the background image is too small to cover the entire page, you can use the image repeat option. This will let you repeat the image multiple times and fill the background completely. The following repeat types can be selected:
      1. X - The image will repeat along the X-axis.
      2. Y - The image will repeat along the Y-axis.
      3. Both - The image will repeat along both the X and Y axe of the lay page.
      4. No Repeat - This prevents the image from being repeated.
  3. Select the Gradient checkbox to create a smooth transition between multiple colors in the background. If you choose multiple colors in a straight line, then the position can be adjusted to offer a perfect blend of all the colors.


Padding determines the space around the content inside a margin/border. To modify padding, select the element and click the Padding checkbox.
  1. Increase Padding: The padding can be increased by dragging the slider to the right. You can also specify the padding in Pixels.
  2. Same padding for all sides: This applies padding on all four sides of the element. You can unselect this checkbox and define different padding for all four sides of the element.

Height and Width

You can either adjust the height and width of the layout by entering the values in pixels, or check the Auto option so that the screen adapts accordingly.

Fit to Screen

The layout will expand and adjust itself according to the length and width of the user's screen. Style options for field label and value

You can customize both the field's label and value using the style options, as well as by choosing options from within the tab. The below image shows the style options for the "Date of joining" field. You can customize the style for the "08-May-2023" value as well.
  1. Change the theme as text, heading, normal, bold, or italic.
  2. Change the font, font size, color, case, or strikethrough, or set the text alignment to left, center, or right.
  3. Align the label to left, top, right, or bottom.
  4. Change the background color, border, radius, padding, and margin. Style options for custom functionalities and custom actions

For custom functionalities such as record comments and blueprint stages, you can customize the following.

  1. Change the text theme for comments and links as light, regular, semi-bold, or bold.
  2. Change the background color and border color for the comment button, links, and content.
  3. Change the shapes of the user profile image.
For custom actions, you can customize the following:

  1. Change the background color and border color for the container and the button.
  2. Change the color, size, and weight for the blueprint stage labels and stage names. Style options for sections

The section element can be customized using:
  1. Background - The options are the same as those available for the layout
  2. Border
  3. Shadow
  4. Radius
  5. Padding - The options are the same as that available for the layout.
  6. Height and width - The options are same as that available for the layout.
  7. Depth


Tick the border checkbox to perform the following:
  1. Adjust thickness: Drag the slider to increase the size of the border. You can also enter the border value in pixels.
  2. Style: Select a border style from the drop-down list.
  3. Color: Choose a color for the border from the color palette or enter HEX code for a color.
  4. Same border for all sides: Check this option to apply the border settings to all the four sides of the section. You can clear this checkbox and define different width, style, and color for each side.


Tick the shadow checkbox to do the following:
  1. X - Based on the value, the shadow will move horizontally (left or right). A positive 'X' value will place the shadow on the right side of the element. A negative value will push the shadow to the left.
  2. Y - Based on the value, the shadow will move vertically (top or bottom). A positive 'Y' value will place the shadow at the top and a negative 'Y' value will push it to the bottom.
  3. Blur - Defines the sharpness of the shadow. If the blur is 0, the shadow will be sharp. The higher the value, the less sharp the shadow will be
  4. Spread - Adjust the size of the shadow. A positive spread value will increase the shadow and a negative spread value will decrease it.
  5. Color - The border color can be chosen from the color picker.


Give rounded corners to the section element by defining its radius. Tick the Radius checkbox to do the following:
  1. Increase radius: Drag the slider to increase the radius or enter a value in the box. 
  2. Same radius for all sides: Check the option to keep the radius size the same for all four sides. You can also uncheck the option and define different radius sizes for each side.


You can increase the forward or backward depth of section element. Style options for tab

The bar, layout and container of tabs can be customized using:
  1. States
  2. Background
  3. Border
  4. Radius
  5. Padding
  6. Margin
Background, border, radius, padding, and margin are same as mentioned above for sections.


You can customize the tab to make it distinct at each of its states: normal, active, and hover. For example, you can set the background color, margins, or background image to be different when the tab is in Active state, for clear distinction between the rest of the states. 
  1. Active - When the tab is selected.
  2. Hover - When you hover over the tab name.
  3. Normal - When the tab is not active or hovered.

  1. You can also change the font, font size, color, case, or strikethrough, or set the text alignment to left, center, or right for each of the above states. Style options for table, text, icon, and line

The common styling options for table, text, icon, and line are
  1. Border
  2. Shadow
  3. Radius
  4. Padding
  5. Depth
Additionally, you can perform the following customizations in text, icon, and line.
  1. Text: You can also change the font, font size, color, case, or strikethrough, or set the text alignment to left, center, or right.

  2. Icon: The icon color, background color, background image, border, shadow, and visibility can be customized.

  3. Line: You can set the line to horizontal or vertical, and adjust the thickness, style, and color.

4. Limitations

  1. This page is relevant to all reports except spreadsheet report.
  1. Understand canvas layout designer
  2. Manage custom layout
  3. Setting canvas layout as default

    Zoho CRM Training Programs

    Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

    Zoho CRM Training
      Redefine the way you work
      with Zoho Workplace

        Zoho DataPrep Personalized Demo

        If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

        Zoho CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now

            Zoho Sign now offers specialized one-on-one training for both administrators and developers.

            BOOK A SESSION

                                      You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.

                                          Manage your brands on social media

                                            Zoho Desk Resources

                                            • Desk Community Learning Series

                                            • Digest

                                            • Functions

                                            • Meetups

                                            • Kbase

                                            • Resources

                                            • Glossary

                                            • Desk Marketplace

                                            • MVP Corner

                                            • Word of the Day

                                              Zoho Marketing Automation

                                                Zoho Sheet Resources


                                                    Zoho Forms Resources

                                                      Secure your business
                                                      communication with Zoho Mail

                                                      Mail on the move with
                                                      Zoho Mail mobile application

                                                        Stay on top of your schedule
                                                        at all times

                                                        Carry your calendar with you
                                                        Anytime, anywhere

                                                              Zoho Sign Resources

                                                                Sign, Paperless!

                                                                Sign and send business documents on the go!

                                                                Get Started Now

                                                                        Zoho TeamInbox Resources

                                                                                Zoho DataPrep Resources

                                                                                  Zoho DataPrep Demo

                                                                                  Get a personalized demo or POC

                                                                                  REGISTER NOW

                                                                                    Design. Discuss. Deliver.

                                                                                    Create visually engaging stories with Zoho Show.

                                                                                    Get Started Now

                                                                                                        • Related Articles

                                                                                                        • Custom card layout for e-commerce app

                                                                                                          Requirement Display products in a card layout with a button to add required products to a cart. Use Case An e-commerce business uses an order management app to process orders. Products need to be displayed in a card layout with product images, and ...
                                                                                                        • Create Custom Layout

                                                                                                          This page is relevant to list type report only. To create a custom layout for quick view: Navigate to the Design page of report. Select Quick View tab. Click Custom Layout. The Build your Layout window will appear. Click From Scratch. Select Text ...
                                                                                                        • Manage custom layout

                                                                                                          1. What Does This Page Cover? Learn how to name, rename, edit, and perform other customizations on the custom layouts you have designed for the detailed view of your records using the Canvas layout builder. Before moving ahead, you can learn more ...
                                                                                                        • Set Quick View Layout

                                                                                                          This page is applicable to all report types except spreadsheet, pivot chart, and pivot table The list type layouts can be broadly classified as tabular and non-tabular. You can do the following: To set tabular layout for list report Navigate to ...
                                                                                                        • Understand Canvas layout designer

                                                                                                          1. What Does This Page Cover? Learn about how you can use Canvas layout builder in Creator to design the detailed view layout of your records, corresponding to your business requirements. 2. Availability This help page is for users in Creator 5 and ...
                                                                                                          Wherever you are is as good as
                                                                                                          your workplace



                                                                                                            Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.


                                                                                                            Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.


                                                                                                            Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.

                                                                                                            CRM Tips

                                                                                                            Make the most of Zoho CRM with these useful tips.

                                                                                                              Zoho Show Resources