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

            Get started with Zoho Sign

            in a few quick steps!

            Download Help Guide

                        Still can't find what you're looking for?

                        Write to us:



                          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 SalesIQ Resources

                                                    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

                                                                                      • Can I create pipelines for custom module?

                                                                                        No. Multiple sales pipelines can only be created for the Deals module.
                                                                                      • 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 ...
                                                                                      • How is a page layout different from using multiple sales pipelines?

                                                                                        Page layouts are used to capture details of different records in a single module. For example, you need to gather different details from customers who purchase a mobile device than for customers who have a mobile device service. So, though both the ...
                                                                                      • When should I use multiple sales pipelines?

                                                                                        If the way your business works means that the sales process differs based on the product, service, or client, then you need to use multiple pipelines to monitor your sales processes. For example, consider the sales process in a real estate business ...
                                                                                      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