Widgets in Zoho Vertical Studio | Vertical Studio Help Guide

Widgets

Widgets help you extend your vertical application's functionality by embedding or integrating third-party applications. It enables you to pull real-time data from external resources to improve decision-making and streamline workflows within the applications. It enhances productivity by reducing the need to switch between different platforms. Their ability to connect with APIs allows you to integrate your application with a wide variety of applications. 
Check out Installing the CLI and Creating Your First Widget documents for step-by-step guidance on building a widget. 

Javascript SDK 

Refer to the Javascript SDK of the widgets that includes the API wrappers for accessing your application's inbuilt functions. This SDK will help the widget to access/manipulate the data of the subscriber's organization. 

Types of Widgets

Following are a few types of widgets that can be created in the developer console and deployed in the subscriber's organization:
  1. Telephony Widget
  2. Widget in Web Tab
  3. Widget in Related List
  4. Custom Button Widget
  5. Business Card Widget
  6. Getting Started Widget
  7. Homepage Dashboard Widget
  8. Create Records Widget
  9. Blueprint Widget
  10. Setup Widget 
  11. Widget in Help Center
Once you have built the widget, configure it in the Connected Apps of Zoho Developer Console and establish it in relevant places as specified for each type in the following sections. 
Info
The Homepage, Create Records, Setup and Blueprint widgets are currently in Early Access and not yet publicly available. Contact our support team  to enable these features for your account. 

Telephony Widget

A telephony widget connects the vertical application with any third-party telephony service to help users make, receive, and log phone calls without switching tabs. It boosts productivity by providing a centralized space for managing client interactions, improving customer service, and optimizing sales operations.
Once installed, subscribers can initiate phone calls with a single click on the softphone icon or the phone number found within records. 



Embed a Telephony Widget
  1. After creating the widget in Connected Apps, navigate to Telephony in the left pane. 
  2. In the Telephony page, provide the following details:
    1. Name for the widget in Call Center Name field.
    2. A resource path in SandBox URL field.
      This is the relative path to the main view of your telephony widget.
  3. Click Save
 

Widget in Web Tabs

A web tab is displayed like any other module in the subscriber's organization in which you can create modules with UI elements/features that cannot be added using prebuilt or custom modules. Widgets in web tabs make a significant impression than the regular web tabs as they can fetch data from external sources through APIs and display within the subscriber's organization for optimized workflows. 
Below image is a sample widget web tab used for displaying a customer heat map. 

 

Create a Web Tab
  1. Once you have created the widget in Connected Apps, go to Modules in the left pane. 
  2. Shift to the Web Tabs section and click the Create Web Tab button.
  3. Enter the following information:
    1. Name for the widget in Tab Name field.
    2. Select Type as Widget.
    3. A resource path in SandBox URL field.
      This is the relative path to the main view page of your web tab widget.
  4. Click Save
Widgets in related lists can be embedded within the related list view of a record in the records detail page. It elevates the functionality of the standard related lists by providing additional and real-time data from other modules or third-party applications. 
For example, in the Deals module, a related list widget could pull in data from a third-party payment gateway to display real-time payment status for each deal record. This real-time visibility enhances subscriber workflows, reducing the need to switch between different applications to retrieve information.
Here is a sample Related List widget that shows the nearby leads' location to a salesperson. 



Create a Related List Widget
  1. After creating the widget in Connected Apps, go to Components in the left pane. 
  2. Select the Related Details tab and click the Add Widgets button.
  3. Enter the following information:
    1. Name for the related list in the Name field.
    2. Select the name of the Module in which the related list has to be added.
    3. A resource path in the SandBox URL field.
      This is the relative path to the main view page of your related list widget.
  4. Click Save.

Custom Button Widgets

Custom button widgets are specialized buttons that can execute specific actions, whenever triggered. These buttons are typically placed within list view pages or records detail view pages of modules. It allows the subscribers to automate tasks or access third-party services from the application's' interface.
For example, you can embed a Send SMS button in the Contacts module and integrate it with any messaging service to send SMS to a contact. This button can be placed either on the list view page or on the records detail page based on business requirements. 

 
 

Create a Custom Button Widget
  1. Once you have created the widget from Connected Apps, navigate to the Components located in the left pane.
  2. In the Components page, select the Links & Buttons tab.
  3. Click the Create New Button button.
  4. Enter the following information:
    1. Select the name of the Module in which the button has to be displayed.
    2. Name for the button.
    3. Click the Add Description link and specify the functionality of your custom button.
    4. Choose the location to place the custom button.
    5. Select Invoke a Widget as the action to be executed by the custom button.
    6. A resource path in the SandBox URL field.
      This is the relative path to the main view page, which will be displayed when your custom button widget is clicked.
  5. Click Save.
 

Business Card Widget

Data in the records detail view page can be presented in a variety of modes. Business card widgets help you embed UI components and graphical data representations within the specific record. It helps you display data in new formats and derive diverse information that is not supported in the usual framework of the application. 
Following are a few use cases of Business Card Widgets:
  1. Display the degree of completion for details in any module record 
  2. Display related product suggestions
  3. Display infographics or statistical data related to the record
  4. Indicate progress of a process or steps covered in a process
 


Create a Business Card Widget
  1. Once you have created the widget in Connected Apps, go to the Components in the left pane.
  2. Select the Business Card Widget tab and click Create Widget.
  3. Provide the following details:
    1. Enter a name for the widget in the Widget Name field.
    2. Select the Module to view the business card widget in.
    3. Enter a resource path in the SandBox URL field.
      This is the relative path to the main view page of your business card widget.
  4. Click Save.
 

Getting Started Widget

A Getting Started widget in an application will help in guiding the subscribers through essential steps and procedures to aid them in becoming familiar with it swiftly and efficiently. It can also simplify the onboarding by highlighting the essential actions, features, and procedures. 
For example, you can design a widget for an onboarding Sales Manager to help them set up the environment to track leads, manage deals, and collaborate with sales teams. 

Create a Getting Started Widget
  1. Once you have created the widget in Connected Apps, navigate to Startup Actions > Getting Started Widget on the left menu. 
  2. Provide the following details:
    1. Enter a name for the widget in the Widget Name field.
    2. Choose the connected application with which you want to create a settings widget. 
    3. Enter a resource path in the SandBox URL field.
      This is the relative path to the main view page of your business card widget.
    4. Specify the Dimension of the widget either in terms of Pixel or Percentage.
    5. Use the Active check box to manage the visibility of the widget in your organization.
  3. Click Save
Info
The Homepage, Create Records, Blueprint, and Setup widget types that we are about to discuss are currently in the Early Access stage. Contact our support team at support@zohodeveloper.com to enable these types for your account.  

Homepage Widget

The Homepage dashboard widgets help you monitor and manage essential business data at a glance. The data may relate to tracking performance metrics, visualizing trends, and keeping up with other key activities that require immediate attention. It reduces the time spent on navigating through different modules, their reports, and other third-party applications, thereby enhancing productivity. 
Following are a few use case scenarios where the Homepage widget can be useful:
  1. You can display the most recent blogs by the CEO on your dashboard to stay updated on the market. 
  2. For a Customer Support team, their dashboard widget can display the number of tickets closed by each teammate to inject enthusiasm and increase productivity. 
Here is a sample home page widget with an external calendar.

 

Create a Homepage Widget
  1. Once you have created the widget in Connected Apps, go to Homepage Widget on the left menu. 
  2. Click Create Widget and provide the following details:
    1. Enter a name for the widget in the Widget Name field.
    2. Choose the connected application with which you want to create a settings widget. 
    3. Enter a resource path in the SandBox URL field.
      This is the relative path to the main view page of your setup widget.
  3. Click Save
 

Create Records Widget 

The Create Records widget allows you to create custom interfaces for creating your records. Unlike the default create page, you can modify the layout, incorporate additional logic, and customize workflows for your specific business requirements. It provides greater flexibility and control over the data-entry process. 
For example, you can create customized create pages for different roles for the Accounts Module, such as a quick form for Sales Reps and a detailed form for analysts. 

Configure a Create Records Widget
  1. After creating the widget in Connected Apps, navigate to Build > Modules on the left menu. 
  2. Shift to the Widgets tab and provide the following details:
    1. Enter a name for the widget in the Widget Name field.
    2. Choose the module in which you want to customize the create page with widget. 
    3. Pick where you want to display the widget in the Show in field.
    4. Choose the connected application with which you want to create a settings widget. 
    5. Enter a resource path in the SandBox URL field.
      This is the relative path to the main view page of your business card widget.
  3. Click Save.
 

Widget in Blueprint

Blueprints help you define and enforce structured processes for your records by mapping out every step in a process and specifying conditions for transitions.
A widget in this area could assist and aid subscribers through each stage with relevant information and actions. This results in maintaining elevated consistency and efficiency for complex sales and support processes. 
For example, consider a loan approval process that requires checking the previous loan history of the client. You can deploy a widget in between the blueprint transitions to check the loan history and move forward with the approval process. 

Notes
Note:

You can create a maximum of four blueprint widgets for an application. \
Create a Widget in Blueprint
  1. Once you have created the widget in Connected Apps, go to the Blueprint Widget on the left menu. 
  2. Click Create Widget and provide the following details:
    1. Enter a name for the widget in the Widget Name field.
    2. Choose the connected application with which you want to create a settings widget. 
    3. Enter a resource path in the SandBox URL field.
      This is the relative path to the main view page of your setup widget.
  3. Click Save.
 

Widget in Setup Page

This helps in adding new menu items or customized options in the Setup page. You can create a more intuitive and efficient setup experience to enhance productivity. With this, you can bring in various custom settings that are non-native to the application at one place, provide product/feature walkthroughs or directly connect with third-party applications based on your requirements. 
For example, you can add Developer Help Documents to the menu and embed tutorial videos of the application using this widget. 

 
Notes
Note:

You can create a maximum of four setup page widgets for an application. 
Create a Widget in Setup page
  1. Once you have created the widget in Connected Apps, navigate to the Setup Widget on the left menu. 
  2. Click Create Widget and provide the following details:
    1. Enter a name for the widget in the Widget Name field.
    2. Choose the connected application with which you want to create a settings widget. 
    3. Enter a resource path in the SandBox URL field.
      This is the relative path to the main view page of your setup widget.
  3. Click Save.
  

Widget in Help Center

You can embed help resources directly into your application using a custom widget. This widget allows users to connect with the support team through various channels, such as raising a ticket, using a chat assistant, submitting a voice recording, making a call, or initiating a video chat. Additionally, you can also use the widget to embed resources like a knowledge base, community forums, social media links, and other helpful content to provide a comprehensive support within your application.
Here is a sample of the quick access icon in a subscriber's organization. 

 
The support you configure under Help Access will also be available under the profiles tab. 
 
Create a Widget in Help Center 
  1. Once you have created the widget in Connected Apps, navigate to Package > Branding > Help Center on the left menu. 
  2. Toggle the Help Access field. 
  3. In the pop-up, choose the Access Type as In-app Widget and provide the following details:
    1. Select the Connected App from the drop-down field. 
    2. In the Index Page, enter the resource path of your widget index file. 
    3. Specify the Dimension of the widget either in terms of Pixel or Percentage.
    4. Enter the Pricing Plans that should have access to this support feature for the application. 
    5. Select the View Place box and choose the icon that suits your requirement. 
    6. Provide a display name for the icon in the Label
  4. Click Save.


      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 FormsRetailOnline Data Collection Tool
                              Embeddable FormsBankingBegin Data Collection
                              Interactive FormsWorkplaceData Collection App
                              CRM FormsCustomer ServiceForms for Solopreneurs
                              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
                              Forms for Government
                              Intake FormsLegal
                              Mobile App
                              Form DesignerHR
                              Mobile Forms
                              Card FormsFoodOffline Forms
                              Assign FormsPhotographyMobile Forms Features
                              Translate FormsReal EstateKiosk in Mobile Forms
                              Electronic FormsInsurance
                              Drag & drop form builder

                              Notification Emails for FormsAlternativesSecurity & Compliance
                              Holiday FormsGoogle Forms alternative GDPR
                              Form to PDFJotform alternativeHIPAA Forms
                              Email FormsWufoo alternativeEncrypted Forms
                              Accessible FormsTypeform alternativeSecure Forms

                              WCAG

                                          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

                                                                  Use cases

                                                                  Make the most of Zoho Desk with the use cases.

                                                                   
                                                                    

                                                                  eBooks

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

                                                                   
                                                                    

                                                                  Videos

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

                                                                   
                                                                    

                                                                  Webinar

                                                                  Sign up for our webinars and learn the Zoho Desk basics, from customization to automation and more

                                                                   
                                                                    
                                                                  • Desk Community Learning Series


                                                                  • Meetups


                                                                  • Ask the Experts


                                                                  • Kbase


                                                                  • Resources


                                                                  • Glossary


                                                                  • Desk Marketplace


                                                                  • MVP Corner



                                                                    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

                                                                                                                            • Building Connected Apps

                                                                                                                              An Overview The Connected Apps in Zoho Vertical Studio are widgets that help you embed or integrate third-party applications directly into your solution. The data exchange between your solution and the third-party application is established using ...
                                                                                                                            • Web Tabs

                                                                                                                              Web Tabs in Vertical Studio enables you to embed contents such as third-party web applications or web pages in your application in the form of module(s). This helps you to offer additional functionalities and resources into the application without ...
                                                                                                                            • Components and Packaging in Zoho Vertical Studio

                                                                                                                              Components are fundamental building blocks of Vertical Studio applications, comprising functionalities, configurations, and customizations. These components, such as fields, modules, blueprints, widgets, and templates, work together to create a ...
                                                                                                                            • Zoho Vertical Studio - Overview

                                                                                                                              Zoho Vertical Studio is a robust low-code platform designed to help developers and businesses create, customize, and deliver SaaS applications tailored to the unique needs of specific industries. By offering an extensive suite of pre-built tools, ...
                                                                                                                            • Subforms

                                                                                                                              Subforms help you to include additional data tables within a primary module record in your vertical application. They are used to manage and display multiple related data entries associated with a single record, providing a structured way to organize ...
                                                                                                                              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