Custom Menu - an overview

Custom Menu - an overview

Feature Availability

Overview

Custom Menu in Zoho Connect lets you add customized menus to entities such as status, tasks, events, in addition to the default menus—Follow, Print, Bookmark, and Copy post URL that are already available. They can be shared with a set of users or Groups and can be used to solve specific use cases.
 
Handlers associated with a custom menu
 
A custom menu has four handlers with each having a defined purpose. You can use Deluge scripts to write a custom function in these handlers and define how the menu should work.  Click here to learn more about Deluge scripts
 
Menu click handler: This handler is triggered once the user clicks the custom menu option from the dropdown. You can use this to perform a simple one-step action or open a form to get user inputs.
 
Form change handler: This handler can be used if the fields in the form box should dynamically change values based on the user input. For eg., options in field B should change based on the user's input in field A. 
 
Field Lookup Handler: This handler can be used to perform a custom lookup and fetch results matching the input entered by the user in the select/multiSelect field.
 
Form submit handler: This handler is used for form submission. The user inputs are validated and a success/failure message is displayed.

For optimal functioning of a custom menu, the execution time of each handler should not exceed 20 seconds. 

Who can create a custom menu?  

By default, only the network admins can create custom menus. However, if allowed by the network admin, selected users in the network will be able to create custom menus.

Which entities support custom menu? 

Custom menu is supported in the following Zoho Connect entities — conversation, announcements, polls, questions, events, tasks, and forums. 

How do I create a Custom Menu?  

  1. Click the gear icon [] from the menu in the right.
  2. Select Settings from the dropdown.
     
  3. In the Settings page, select Custom Menu under Developer Space.
  4. In the Configuration details page, enter the menu name that should be displayed in the dropdown.
  5. Select who should access the menu and the entities in which the menu should be available.
  6. Click Save & edit code.
     

  7. Write the custom function in the required handlers.
  8. Click Publish found in the top-right corner of the page to make it available to the shared users.
 If you have not published the custom menu, it will be saved as draft and only you'll be able to access it. To check if the custom menu is working as intended, you can save the menu as draft and try using it. 

How do I edit a custom menu?

  1. Click the gear icon [] from the menu in the right.
  2. Select Settings from the dropdown.
     
  3. In the Settings page, select Custom Menu under Developer Space.
  4. Select the required menu from the list.
  5. In the Configuration details pop-out, click the Edit Configuration.

  6. Now, make changes to the basic details of the menu and the function in its handlers.
  7. Click Save.
If you need to make changes to a published custom menu without affecting its functioning, you can duplicate the menu, make the required changes, then update the changes to the original one. You will be provided with the option to update the changes to the original menu when to try to publish the duplicated menu. 

How do I duplicate a custom menu? 

You can duplicate and create a new custom menu from a published menu. 
  1. Click the gear icon [] from the menu in the right.
  2. Select Settings from the dropdown.
     
  3. In the Settings page, select Custom Menu under Developer Space.
  4. Select the required menu from the list.
  5. In the Configuration details pop-out, click the the duplicate icon [] in the top-right corner.
     
The custom menu will be duplicated. You can now make changes to it, as per your needs.

 The duplicate option is not available in the menus that are in draft mode. 

How do I disable or delete the custom menu?

  1. Click the gear icon [] from the menu in the right.
  2. Select Settings from the dropdown.
     
  3. In the Settings page, select Custom Menu under Developer Space.
  4. Select the required menu from the list.
  5. In the Configuration details pop-out, toggle the button in the top-right corner to disable it.
     
  6. In the Configuration details pop-out, click the trash icon []  in the top-right corner to delete it.

Execution logs

The logs in each custom menu will list the details of every execution made. The details include who executed the menu, time of execution, the results, the parameters passed, and return data. The logs can be used to analyze and debug issues in the menu. 
 
At times, the user might have chosen not to share the menu usage details with the menu developer. In such cases, the menu creator can only see the user name, status and time of execution. And, when there is an execution failure, the menu developer can request the user to provide permission to share usage details to help in debugging the issue. 
 
Even after the user provides permission, the menu developer will not be able to view the details of the past execution. So, they can request the user to perform the same action once again and get the details of the failure logged.  

To view logs: 
  1. Click the gear icon [] from the menu in the right.
  2. Select Settings from the dropdown.
     
  3. In the Settings page, select Custom Menu under Developer Space.
  4. Select the required menu from the list.
  5. In the Configuration details pop-out, click the Edit Configuration.

  6. Scroll down to Logs and click Expand next to it.
     
The logs will be stored for the last 1 year only. 

Allowing custom menu to access user data

The custom menu will collect certain information from the user profile depending on its function. A user trying to access a custom menu for the first time will see a screen asking them to provide permission to access information. However, the user can revoke the permissions they have given whenever they want to. 
 
To revoke or change the given permissions:
  1. Click the gear icon [] from the menu in the right.
  2. Select Settings from the dropdown.
     
  3. In the Settings page, select Custom Menu under Developer Space.

  4. Select the required menu from the list.
  5. Click the View Granted Permissions in the bottom-right corner of the Configuration details pop-out.
  6. You can revoke/provide the required permissions from the list.

Execution Limit 

Zoho Connect has a limit on the number of handler executions made in a network per day. This limit differs with each subscription plan and can be increased by either upgrading to a higher plan or contacting Zoho Connect's support team. Once you have exhausted the maximum limit, all custom menus in your network will stop working for the rest of the day. And, the menus will resume functioning by 12.00 AM based on your network's data center location. 
 
To view your network's usage details,
  1. Click the gear icon [] from the menu in the right.
  2. Select Settings from the dropdown.
     
  3. In the Settings page, select Custom Menu under Developer Space.
  4. You'll see the usage details in the top-right corner of the page.
If you have any questions related to Custom Menu, write to us at support@zohoconnect.com. We're happy to help!

    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









                                            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

                                                                                                              • Overview of Custom Roles in Zoho Connect

                                                                                                                Feature Availability Overview You can use Custom Roles in Zoho Connect, to give individuals the ability to manage specific areas of your network. For example, you can permit one member to add new users to the network while preventing them from ...
                                                                                                              • Overview of Custom Apps in Zoho Connect

                                                                                                                Overview Most organizations spend a considerable amount of time and resources on data collection and building apps for everyday use cases like cab requests, appointment booking, and onboarding applications. But with custom apps, these processes can ...
                                                                                                              • Menu Click Handler

                                                                                                                Overview The menu click handler will be triggered whenever the user selects the custom menu option from the dropdown. It can be used to perform a simple one-step action such as sharing a post link to a particular user on Cliq, or  open a form to ...
                                                                                                              • Ideas - an overview

                                                                                                                Feature Availability Overview The Ideas module in Zoho Connect gives a dedicated space to share, discover, crowdsource, and evaluate the most impactful ideas from everyone in an organization. Additionally, they can be categorized and placed in ...
                                                                                                              • Dashboard - an overview

                                                                                                                Feature Availability Overview The dashboard is a centralized place to view and share important information with all users in the network. With 50+ widgets, the dashboard is a great way to share news, images, links, and announcements and quickly ...
                                                                                                                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