Understanding Custom Actions

Understanding Custom Actions

Custom Actions lets application builders add named action buttons to widgets or any module/model. Users can trigger workflows, update fields, navigate to related records, execute device commands, or open URLs directly from device views. There are two main categories based on which the button placement is done; Dashboard and Modules. And each button is linked to one of four action types.

Let's see in detail about the categories, actions types that can be configured for the action buttons, and their placement.
 

Categories

Dashboard

Select the Dashboard category to display a custom action button on a dashboard. After creating the button, add it to the dashboard using the Custom Button widget while creating or editing the dashboard. Each button can perform one of the following actions:
  1. Open a URL
  2. Open a module page, such as a data visualization module (Maps, Reports, etc.) or a list view (like Assets)

Sample Use case:

A facility manager wants a quick way to jump from the dashboard to the live Map view of all connected assets, instead of navigating through menus. A custom action of the Dashboard category type lets you add a button widget that opens the Map module directly from the dashboard.

For this, you need to create a custom action with category as Dashboard and module as Maps to invoke a live asset map. Learn More
 

Module

Module custom buttons appear in multiple slots on the respective module or model page. Each button can do one of the following:
  1. Open a URL
  2. Open a module page, such as a data visualization module (Maps, Reports, etc.) or an Assets view (any tab)
  3. Trigger a workflow
 
Sample Use Case 1:

A technician viewing an Asset record wants to quickly trigger a maintenance workflow without leaving the page. A custom action of the Module category type lets you add a button on the Asset module page that triggers this workflow directly.

For this, you need to create a custom action with category as module and asset, and workflow as action type. Learn More

Sample Use Case 2:

A building operator viewing an Energy Meter record wants to quickly check its consumption trends without manually searching in Reports. A custom action of the Module category type, created for the Energy Meter model, lets you add a button that opens the relevant Report directly from the Energy Meter page.

For this, you need to create a custom action with category as module and action type as module and reports. Learn More

Action Types

Each custom action button is bound to one of the following action types. The action type determines what happens when the user clicks the configured action button. 

  1. Open Module Page  

Navigates the user to a specified module or model page within the end application. Use this action to link related records or guide users to relevant sections.

  1. Open Sigma Extension  

Triggers a Sigma extension when the button is clicked. This action is useful for launching custom functionalities built by developers. 

  1. Open URL  

Opens an external or internal URL when the button is clicked. This action is useful for linking to dashboards, documentation, or third-party tools.

  1. Execute Workflow  

Triggers a predefined workflow associated with the record. This action type is available on Standard plans and above.
 
Notes
Note
  1. Execute Workflow is restricted to Standard plans and above.
  2. Ensure the workflow is published and active before assigning it to a custom action button.


Action Button Placement Slots

Custom action buttons can be placed in six different locations within the end application. Each placement slot determines where and when the button is visible to the user.

  1. List View — Utility Bar

Top-right of the list view. Applies to all rows.


 
  1. List View — Column Action

In the Actions column for each individual row in the list view.

 
  1. Single Record — On Select

In the record header toolbar when viewing a single device record.

            
 
  1. Multiple Records — On Select

In the selection toolbar when two or more records are checked.


 
  1. Single Record — Details Page

In the action area of the record's Details tab

 


Confirmation Dialog 

Confirmation dialog can be configured for any custom action button. When enabled, users see a prompt before the action is executed. This helps prevent accidental triggers.
 

        Create. Review. Publish.

        Write, edit, collaborate on, and publish documents to different content management platforms.

        Get Started Now


          Access your files securely from anywhere

            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







                                Quick LinksWorkflow AutomationData Collection
                                Web FormsEnterpriseOnline Data Collection Tool
                                Embeddable FormsBankingBegin Data Collection
                                Interactive FormsWorkplaceData Collection App
                                CRM FormsCustomer ServiceAccessible Forms
                                Digital FormsMarketingForms for Small Business
                                HTML FormsEducationForms for Enterprise
                                Contact FormsE-commerceForms for any business
                                Lead Generation FormsHealthcareForms for Startups
                                Wordpress FormsCustomer onboardingForms for Small Business
                                No Code FormsConstructionRSVP tool for holidays
                                Free FormsTravelFeatures for Order Forms
                                Prefill FormsNon-Profit

                                Intake FormsLegal
                                Mobile App
                                Form DesignerHR
                                Mobile Forms
                                Card FormsFoodOffline Forms
                                Assign FormsPhotographyMobile Forms Features
                                Translate FormsReal EstateKiosk in Mobile Forms
                                Electronic Forms
                                Drag & drop form builder

                                Notification Emails for FormsAlternativesSecurity & Compliance
                                Holiday FormsGoogle Forms alternative GDPR
                                Form to PDFJotform alternativeHIPAA Forms
                                Email FormsFormstack alternativeEncrypted Forms

                                Wufoo alternativeSecure Forms

                                TypeformWCAG


                                    All-in-one knowledge management and training platform for your employees and customers.

                                              Create. Review. Publish.

                                              Write, edit, collaborate on, and publish documents to different content management platforms.

                                              Get Started Now





                                                                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


                                                                      • Desk Community Learning Series


                                                                      • Digest


                                                                      • Functions


                                                                      • Meetups


                                                                      • Kbase


                                                                      • Resources


                                                                      • Glossary


                                                                      • Desk Marketplace


                                                                      • MVP Corner


                                                                      • Word of the Day


                                                                      • Ask the Experts


                                                                        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 Demo

                                                                                                          Get a personalized demo or POC

                                                                                                          REGISTER NOW


                                                                                                            Design. Discuss. Deliver.

                                                                                                            Create visually engaging stories with Zoho Show.

                                                                                                            Get Started Now








                                                                                                                                • Related Articles

                                                                                                                                • Working with Custom Actions

                                                                                                                                  Custom Actions lets application builders add named action buttons to any module/model or dashboard. Users can trigger workflows, update fields, navigate to related records, execute device commands, or open URLs directly from device views and ...
                                                                                                                                • Understanding Actions

                                                                                                                                  In an IoT setup, you may have to trigger various actions, such as sending notification emails to relevant personnel, connecting to a third-party URL via. webhook, executing custom business logic on certain conditions, or sending notifications as ...
                                                                                                                                • Understanding Custom Fill Widgets

                                                                                                                                  Custom Fill widgets in Zoho IoT provide a visually engaging way to represent level-based metrics such as water or battery levels. These widgets use dynamic fill animations and customizable styles to offer a more intuitive and aesthetically appealing ...
                                                                                                                                • Understanding Holidays

                                                                                                                                  Note: The Holiday feature is not available by default. Please contact support at support@zohoiot.com for enabling the feature in your application. The Holiday Management Module in Zoho IoT allows organizations to define and manage holidays centrally ...
                                                                                                                                • Editing a custom datapoint group in the end application

                                                                                                                                  Custom datapoint groups can be edited to modify their name and description. Note: Datapoint groups imported from the gallery cannot be edited. To edit a datapoint group in the end application, Access the End Application. Click the Settings icon in ...
                                                                                                                                  Wherever you are is as good as
                                                                                                                                  your workplace

                                                                                                                                    Resources

                                                                                                                                    Videos

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



                                                                                                                                    eBooks

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



                                                                                                                                    Webinars

                                                                                                                                    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