Troubleshooting Pipelines | 09/05/2022

Troubleshooting Sales Pipelines

1. I created a pipeline and now I cannot update the Stage field in a record.

Creating a pipeline does not affect updating stages in the layout.
If a map dependency, blueprint, layout rule, or validation rule has been created based on the Stage field, then you won't be able to update the Stage field.


2. How can I map the pipeline and stage during Hubspot (API) migration?

By default, the stage and pipeline in HubSpot are automatically mapped to the Stage and Pipeline fields in Zoho CRM and you cannot alter this mapping during API migration.
If you need to migrate stages and pipelines in a different format, then you will need to export the data from HubSpot as a spreadsheet and manually importing that data into Zoho CRM, which will allow you to manually map the fields.

3. When I try to deploy a pipeline from the sandbox, I see an error telling me to try again later or contact support.

Try deploying the fields first, then the sections, then the layout, and then finally the pipeline, if you face this issue instead of deploying them all at once.
If the issue still persists, then please contact our support team.

4. I created a new pipeline and then deleted the standard pipeline, but the Kanban view still shows stages from the deleted pipeline.




If the stage values are mapped on the stage probability mapping page, then the stage will also be shown in the Kanban view.

To remove the stage value from the stage probability mapping, go to Setup and select Modules & Fields from the Customization section. Hover your mouse over Deals and select Stage Probability Mapping, then remove the stage value from the list.

5. The Pipeline feature is missing from the Customization list on the Setup page.

Ensure that the Deals module has been enabled in on the Organize Modules screen by navigating to Setup > Customization Module and Fields > Organize Modules and selecting Enable Deals/Potentials. Also ensure that profile permissions are enabled for the Deals module by navigating to Setup > Security Control > Profiles and selecting the user's profile.
Scroll down to the permissions for the Deals module and enable them if they are not already enabled.

6. When Kanban view is selected, all the stages that are in the Stage-Probability Mapping are displayed instead of the stages in the default pipeline.


If multiple pipelines have been created, the All Layouts view will open by default when you select the Kanban view. This also means the stages from all pipelines will be available for mapping. If you select a particular pipeline, then only the stages in that pipeline will be displayed in the list view.


7. Can I edit or delete stage fields from the pipeline when a record from that pipeline is in a blueprint?


No. When a record enters the blueprint, you will no longer be able to edit the Pipeline field in the record as it will be locked.


8. When I try to pass information about a pipeline through API, I see an error message saying,

"details": {},
"message": "invalid oauth scope to access this URL",
"status": "error"

Ensure that, you are passing the access token as a parameter in the API request and that the generated access token includes the pipeline scope.
Also make sure that you are using the proper Layout ID by navigating to Setup Modules and Fields > Deals and then open the required layout and copy the ID from the URL and paste it into the code.
The pipeline scope to include is: scope=ZohoCRM.settings.pipeline.ALL


9. When I try to delete a pipeline, I see an error message that says "Pipeline field cannot be removed".



If the pipeline is associated with records in the Deals module or with a blueprint, then you cannot delete it. You must first remove the associations and then you can delete the pipeline.



10. How does sorting based on the Stage field work in a dashboard when there is a pipeline created?  

In the dashboard, the shown based on their initial (default) order, which is the order they were created in (regardless of any pipelines they appear in).
For example, if a stage value "Requirement Received" is created today and then another value "Analysing Prospect" is created tomorrow, then when a dashboard is sorted by stage value, the records with the value "Requirement Received" will be displayed first, then the records with the "Analysing Prospect" value.


11. I see an internal server error when I try to change the pipeline of a deal record.


Check whether the stage field has been used to map any dependencies and whether a layout rule has been created based on the stage field.

If these troubleshooting steps don't resolve your problem, please feel free to send us an email at

    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

                                                                                            You are currently viewing the help articles of Sprints 1.0. If you are a user of 2.0, please refer here.

                                                                                            You are currently viewing the help articles of Sprints 2.0. If you are a user of 1.0, please refer here.

                                                                                                  • Related Articles

                                                                                                  • Troubleshooting Module Customization

                                                                                                    Troubleshooting Modules and Fields 1. Why does the editor go from top to bottom instead of left to right when I click the Tab key while creating or editing a record? The order depends on the Tab Order Preference set by the Admin for each particular ...
                                                                                                  • Multiple Sales Pipeline

                                                                                                    What is a sales pipeline? A sales pipeline is a visual representation of your sales process that shows where your prospects are in the buying cycle, how many open deals you have, how long a particular deal stayed in each stage, and whether you have a ...
                                                                                                  • Why your business needs multiple sales processes in your CRM?

                                                                                                    The sales process in CRM is generally referred to as the "sales pipeline." You may have multiple sales pipelines depending on the products you offer and your business needs. Zoho CRM gives you full control over your sales processes by making you the ...
                                                                                                  • FAQs: Multiple Sales Pipeline

                                                                                                    1. What is a sales pipeline? A sales pipeline is a visual representation of your sales process that shows where your prospects are in the buying cycle, how many open deals you have, how long a particular deal stayed in each stage, and whether you ...
                                                                                                  • FAQs: Deals

                                                                                                    Why am I not able to enter the Expected Revenue for deals? The Expected Revenue is automatically calculated based on the Stage and Amount details that you specify for leads, accounts, deals, or any other module. Hence, you cannot enter that value in ...
                                                                                                    Wherever you are is as good as
                                                                                                    your workplace



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


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


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

                                                                                                      CRM Tips

                                                                                                      Make the most of Zoho CRM with these useful tips.

                                                                                                        Zoho Show Resources