Kaizen 147 - Frequently Asked Questions on Zoho CRM Widgets

Kaizen 147 - Frequently Asked Questions on Zoho CRM Widgets




Heya! It's Kaizen time again, folks!

This week, we aim to address common queries about Zoho CRM Widgets through frequently asked questions from our developer forum. Take a quick glance at these FAQs and learn from your peers' inquiries. 

1. Where can I use Widgets in Zoho CRM?

You can create and use widgets in the following ways:
2. Is it possible to create Zoho CRM Widgets using React JS?

Yes, Zoho CRM Widgets can be built using any client-side framework, including React JS. Refer to this Kaizen post for a detailed, step-by-step guide on building a widget with React JS.

3. What is the maximum number of files you can include in a Zoho CRM Widget project?

The maximum number of files allowed in a Zoho CRM Widget project is 250.

4. What is the maximum size of a Zoho CRM Widget project?

The maximum size of a Zoho CRM Widget project is 25MB with each file size limited to 5MB

5. How can I get parameters within a Zoho CRM Widget?

To use data available on a page as parameters, use the following PageLoad listener in your widget code:

ZOHO.embeddedApp.on("PageLoad",function(data){
      // your function code to process the parameters
});

6. How do I use the JS SDK in Zoho CRM Widgets?

To use the JS SDK in widgets, add the following CDN URL as a src within the head tag in your widget code:


7. Is it possible to render widgets using Client Script?

Yes, you can render widgets in Zoho CRM using Client Script in pop-ups and call-outs. Refer to this Kaizen post for a complete working example.

8. Can I pass data from a widget to Client Script?

Yes, you can pass data from widgets to Client Script by registering the following listener with the EmbeddedApp:

ZOHO.embeddedApp.on("NotifyAndWait", function (data) {
      console.log("Client Script synchronous flyout notification", data);
     ZDK.Client.sendResponse(data.id, { choice: 'mail', value: 'example@zoho.com' });
})

Refer to this Kaizen post for a complete working example. 

9. Is it possible to close the widget when a button within the widget is clicked and open a new tab?

Yes, you can achieve this using the ZOHO.CRM.UI.Popup.close() method from the provided JS SDK and add custom code logic to open a new tab. 

10. How can I pass data to a widget from Client Script?

Register the following listener with the EmbeddedApp to pass data from Client Script:

ZOHO.embeddedApp.on("Notify", function (data) {
      console.log("Client Script flyout notification", data);
});

11. How do you use the Dial and DialerActive listeners in Zoho CRM Widget?

When you don't have a native telephony extension for your Zoho CRM organization, you can use the Dial and DialerActive listeners specified in this help page to load a third-party telephony app inside the widget.

12. What does the DialerActive listener do in a telephony widget extension?

Whenever the telephone icon near an entity's phone number is clicked, the DialerActive listener loads the entity's phone number onto a third-party's dial pad that has been loaded within the widget. 

13. How to open a dial pad in a widget within Zoho CRM to make calls?

Integrate a third-party telephony application in your widget and register the following listener with the EmbeddedApp to invoke the Dial pad within a widget:

ZOHO.embeddedApp.on("Dial",function(data){
      console.log("Number Dialed");
});

Hope this post was beneficial and provided the necessary information. 

If you have any queries, feel free to drop them in the comments section below or reach out to us directly at support@zohocrm.com. We eagerly await your thoughts and feedback on this!

Cheers! 

----------------------------------------------------------------------------------------------------------------------------------------

Recommended Reads 

----------------------------------------------------------------------------------------------------------------------------------------


    Access your files securely from anywhere







                        Zoho Developer Community





                                              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


                                                        • Sticky Posts

                                                        • 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.
                                                        • 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.
                                                        • 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

                                                                                                        • Lookup fields

                                                                                                          Is there any way to add Lookup fields to Zoho FSM -- I do not see the option but I see default lookup fields in different modules
                                                                                                        • Inventory Barcode Creation - Add Picture of Item

                                                                                                          Hi I am trying to set up bar code labels and include a picture of the item on the label - any idea on how to add that field to the barcode generator?
                                                                                                        • Shared Snippets Everyone

                                                                                                          Hi, Now that the Shared Snippets have been released and I think will be the most used feature implemented in 2023 :) Creating and Using Snippets in Ticket Responses - Online Help | Zoho Desk Maintain consistency in ticket responses with shared snippets
                                                                                                        • Please Enable Snippets for Agents Adding Comments

                                                                                                          Snippets and templates are currently enabled for agents when they use the reply functionality. There is currently no way to add a template or snippets when an agent comments. This is really weird. Our agents don't use the reply functionality, only the
                                                                                                        • Topics assigned to Contacts in Campaigns

                                                                                                          I have yet to find an efficient way to assign topics to contacts in campaigns with the new system in place.  We have daily contacts added to our system through various forms and we have to manually go in and add topics to contacts before each email campaign
                                                                                                        • What are people using to send Service based emails?

                                                                                                          Zoho Campaigns is for marketing. Users can unsubscribe from these emails. Service based emails need to be delivered and can without the worry of Can-spam act. What are people using to send service based emails? My mailing list is derived from a database
                                                                                                        • CRM Email Insights Not Working - Status not Changing

                                                                                                          I used to be able to see if a customer opened/read an email in CRM, but I no longer get those status changes inside their record. I have everything enabled and I am sending the email from CRM. The experience center has the status' enabled as well. Any
                                                                                                        • Product and Service

                                                                                                          Hi guys, there is a difference between layout of product and service if Long Description field have some kind of text. Please see screenshot 1 for Service here: https://prnt.sc/7xWwPKd29nWP for Product here: https://prnt.sc/LGmtVd_U6H7q As you can see
                                                                                                        • The Urgent Need for Native Brazilian Payment Integrations: PIX and Direct Bank Connections

                                                                                                          Hello Zoho Team, I am writing to emphasize a critical functionality gap for Zoho Books in the Brazilian market: the lack of modern, native payment gateway integrations. The current options are insufficient. The Mercado Pago integration, for instance,
                                                                                                        • Kits: Option to Hide Associate Items on Documents

                                                                                                          The new Kit type of Composite Item is very helpful, and we're already using it in several different ways. One problem is that there seems to be no way to hide the components on some documents, including Package Slips. There is an option given in settings
                                                                                                        • Better implementation of Item Category on Invoices and Estimates

                                                                                                          1) I have added Item Category as a custom field. Honestly, this should be a native part of the item itself, and either required, optional, or not used.  2) When entering an item on an invoice, you have to enter the first character(s) of the item, otherwise
                                                                                                        • Try CRM for everyone button in the way of workflow

                                                                                                          Please consider using the bottom bar for offers. Using the top bar for offers like "Try CRM for everyone" really gets in the way of my day to day workflow.
                                                                                                        • Zoho CRM email formatting issues

                                                                                                          I have been having a hard time with formatting email templates. It feels like Zoho email is "fighting my edits." It refuses to change size, font, etc. Sometimes, the template looks great, then when the email gets sent, it looks completely different- some
                                                                                                        • Weekly Tips : Seamlessly collaborate with Share Drafts in Zoho Mail

                                                                                                          Ever found yourself stuck wondering how to get input on an important email draft without actually sending it? Maybe you want a teammate’s feedback or approval from your manager—without exposing sensitive info. Or perhaps you are working across different
                                                                                                        • How to Share a workdrive folder outside organization ?

                                                                                                          Hi, Earlier we were using Google Suite and were able to share the google drive folders with external organization ( Auditors , marketing collaterals ) as most of them had a personal gmail account they were able to access it without any issue. How can
                                                                                                        • Zoho CRM Account Duplication via Credit Application Form

                                                                                                          Hi, We send a credit application link to our customers via email, which is managed through Zoho Campaigns. When a customer submits the form, it automatically creates a new account in Zoho CRM. We would like to know how to stop this from creating duplicate
                                                                                                        • Multi file upload

                                                                                                          Hi, I just wonder if one could upload multiple files in one shot, say between one and three files, without adding multiple File Upload fields? Thanks, Alalbany
                                                                                                        • Flexible Milestone Invoicing

                                                                                                          If your Zoho Projects portal is integrated with Zoho Invoice/Books, you can now create an invoice for your milestones. You can enable it under Integration Preference and invoice milestones regardless of the project's billing type. For instance, consider
                                                                                                        • The get records i am getting produts that show in the show in the sub form item list field

                                                                                                          The get records i am getting produts that show in the show in the sub form item list field if(input.Department != null) { // Get filtered records once creator_ptid = zoho.creator.getRecords("harshadgroup","item-master","All_Products","Department == \""
                                                                                                        • Incorrect Handling of XLSX data

                                                                                                          Trying to import an XLSX schedule of bills into Zoho Books I ran across the problem of date formatting. To replicate: Build a CSV file with bill dates in whatever format you like and import it - this should work if you match the "dd/MM/yyy" etc. format
                                                                                                        • Add Zoho Form Submission as Attachment to Zoho CRM Deal using Zoho Deal ID

                                                                                                          Hi Zoho team, I have a Zoho Form in which one of the fields will be hidden but will be defaulted with the Zoho Deal ID. Once the form is submitted, I want to reattach the submitted form (and another uploaded file field) into Zoho CRM Deals record. The crazy part is that Deal Name and Stage are the only two fields available for mapping. I have the actual Deal ID. Why can't I just use that. Can you please fix it so that I can properly attach the submission using Zoho Deal ID instead of name/stage (which
                                                                                                        • Workdrive on Android - Gallery Photo Backups

                                                                                                          Hello, Is there any way of backing up the photos on my android phone directly to a specific folder on Workdrive? Assuming i have the workdrive app installed on the phone in question. Emma
                                                                                                        • Displaying related quotes in sales order and back

                                                                                                          Hi, My colleague liked to see to which sales orders, the quote has been converted. Quote shows Invoices, but not SO. Same, they would like to see the quotes in the sales order, as they can see invoices, packages, shipment, How can we achieve this ? Thank
                                                                                                        • Payment link showing as malicious

                                                                                                          We've had a few customers who have been unable to pay invoices as the payment link (the domain is zohosecurepay.eu) is showing as a malicious website in their browser. Could anyone help with this please?
                                                                                                        • Side bar menu

                                                                                                          It would be great if you could stop the auto collapse of expanded menus when selecting a different module. It would save a lot of mouse clicks for a lot of users that frequently switch between sales & purchases as we do, it's easier to collapse them manually when not required !
                                                                                                        • Export Invoices to XML file

                                                                                                          Namaste! ZOHO suite of Apps is awesome and we as Partner, would like to use and implement the app´s from the Financial suite like ZOHO Invoice, but, in Portugal, we can only use certified Invoice Software and for this reason, we need to develop/customize on top of ZOHO Invoice to create an XML file with specific information and after this, go to the government and certified the software. As soon as we have for example, ZOHO CRM integrated with ZOHO Invoice up and running, our business opportunities
                                                                                                        • Multiple Respondents for One Survey Submission?

                                                                                                          Does anyone know of a way to allow multiple respondents to complete only one  survey and then also see (while completing the survey) the responses for their fellow colleagues who already answered that question? The situation is that our new customers have within their own organization, multiple employees that will need to assist in the one survey response. Since we don't always know which new respondent is the "who" that will have the answer, we need multiple respondents to be able to view the response
                                                                                                        • Bad User: Authenticated but not connected

                                                                                                          Zoho CRM cannot send/receive emails and it appears as if it may be an api configuration change either via Zoho or MS. Does anyone have information on how to fix this error message? I am admin on all my accounts. Zoho and MS are blaming each other.
                                                                                                        • Can you remove the title from the forms?

                                                                                                          I am placing the iframes for my forms on my website.  Is it possible to remove or hide the title of the form so that it doesn't show up on the website? Is it possible to place text in the form like "clicking submit will take you to paypal." thanks
                                                                                                        • Zoho CRM's custom views are now deployable from sandboxes

                                                                                                          This feature is now available for users in the AU, JP, and CN DCs. Hello everyone, We're excited to announce that you can now deploy custom views from sandboxes to your production environment to ensure a smoother transition and save valuable setup time.
                                                                                                        • Create static subforms in Zoho CRM: streamline data entry with pre-defined values

                                                                                                          Last modified on (9 July, 2025): This feature was available in early access and is currently being rolled out to customers in phases. Currently available for users in the the AU, CA, and SA DCs. It will be enabled for the remaining DCs in the next couple
                                                                                                        • Allowing vendors to Upload Purchase Invoices against Purchase Order

                                                                                                          Work Flow: Once Project is executed, We send Purchase order to every Vendors asking them to Share the invoice against the same. Most of the time Vendors Send invoices through Mails but our Finance Team miss to book those Purchase Invoices in Zoho Books.
                                                                                                        • Lost the ability to sort by ticket owner

                                                                                                          Hi all, in the last week or so, we have lost the ability to sort tickets by Ticket Owner. Unlike the other columns which we can hover over and click on to sort, Ticket Owner is no longer clickable. Is it just us, or are other customers seeing this too?
                                                                                                        • Edit Legend of Chart

                                                                                                          I would like to edit the legend of the chart. Every time I enable the legend, I get a very unhelpful (1), and when I try to type to change to what I would desire, nothing happens, which is very frustrating. I've gone through your online tutorials and nowhere can I find a legend settings button. This seems a simple fix, where can edit the legend? Thanks.
                                                                                                        • Mask Name Field in Report

                                                                                                          Is it possible to have the Name field as "Last Name, First Name" in a scheduled report.
                                                                                                        • Custom Project View by Project Group

                                                                                                          Hi Zoho Team, I used to have a custom project view which showed all my active projects (not cancelled or completed) and the list was separated into projects groups. Some time ago, possibly a couple of months ago, I began to see all projects even cancelled
                                                                                                        • Generate a link for Zoho Sign we can copy and use in a separate email

                                                                                                          Please consider adding functionality that would all a user to copy a reminder link so that we can include it in a personalized email instead of sending a Zoho reminder. Or, allow us to customize the reminder email. Use Case: We have clients we need to
                                                                                                        • Online Payment Fees

                                                                                                          We don't take many online credit card payments so the merchant service provider (PayPal) charges us the 2.9% fee for processing the amount. I would like the ability for the fee to be automatically added to the total amount for "ease of payment". We'd
                                                                                                        • Unable to attach the file via the API.

                                                                                                          We are trying to attach files to a Candidate in Zoho Recruit using the API. We reviewed the following API documentation: 🔗 Upload Attachment While this API does allow file attachment via a URL, that’s not what we want — we do not want to attach public-facing
                                                                                                        • Zoho Books (UK) needs to be able to submit a CT600 CTSA return

                                                                                                          As well as a VAT Return, most (if not all) small businesses have to submit a CT600 Corporation Tax Self-Assessment. There are many providers who do this (like Xero) bujt not Zoho. Can you add this to the request list please? Many thanks Steve
                                                                                                        • Next Page