Troubleshooting - User Management | Admin Guide - Zoho Directory

Custom field is being used in the custom Name ID attribute to provide SSO

Description

You may encounter this error when you're trying to disable or delete a custom field.

Reason

When setting up single sign-on (SSO) for Directory apps and custom SAML apps, a value called Name ID can be passed from Zoho Directory to the application. The application will use this Name ID to identify the user trying to sign in. This value will usually be the Primary Email Address. But you can also pass any user information field in Zoho Directory as the Name ID. Learn more about setting Name IDs

If the Name ID is not passed to an app, SSO for the app might fail. So you will not be allowed to disable or delete a custom field if the custom field is set as the Name ID of a Directory or a custom app.

Solution

  1. Sign in to Zoho Directory.
  2. Click Admin Panel in the left menu.
  3. Click Users, then click the Manage Fields tab.
  4. Hover over the custom field you're trying to delete, click , then click Disable or Delete. You will be shown an error message containing the list of apps in which this custom field is being used.
    error message shown when deleting a custom field
  5. Note down the names of the apps.
  6. Click Applications in the left menu, then click on the app that is blocking the field from being deleted.
  7. Go to the Single Sign-On tab, then click on the Service Provider Details in the tab.
  8. In the Credential Details section, check if the Application Username field is set as the custom field, or as Custom.
    1. If it is set as the custom field, change it to something else.
    2. If it is set as Custom, edit the Expression Value field and reconstruct the expression to exclude the custom field.
    Note: This action might disrupt SSO and prevent your users from signing in to the app. Ensure you make the changes carefully on both Zoho Directory and the SSO app to avoid service disruption.
  9. Repeat steps 6-8 to remove the custom field from all the required apps.
  10. Try disabling or deleting the custom field again using steps 1-4.


        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 FormsEnterpriseOnline Data Collection Tool
                                Embeddable FormsBankingBegin Data Collection
                                Interactive FormsWorkplaceData Collection App
                                CRM FormsCustomer ServiceAccessible Forms
                                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

                                Intake FormsLegal
                                Mobile App
                                Form DesignerHR
                                Mobile Forms
                                Card FormsFoodOffline Forms
                                Assign FormsPhotographyMobile Forms Features
                                Translate FormsReal EstateKiosk in Mobile Forms
                                Electronic Forms
                                Drag & drop form builder

                                Notification Emails for FormsAlternativesSecurity & Compliance
                                Holiday FormsGoogle Forms alternative GDPR
                                Form to PDFJotform alternativeHIPAA Forms
                                Email FormsFormstack alternativeEncrypted Forms

                                Wufoo alternativeSecure Forms

                                TypeformWCAG


                                    All-in-one knowledge management and training platform for your employees and customers.

                                              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


                                                                      • Desk Community Learning Series


                                                                      • Digest


                                                                      • Functions


                                                                      • Meetups


                                                                      • Kbase


                                                                      • Resources


                                                                      • Glossary


                                                                      • Desk Marketplace


                                                                      • MVP Corner


                                                                      • Word of the Day


                                                                      • Ask the Experts


                                                                        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

                                                                                                                                • Custom authentication with CyberArk

                                                                                                                                  Prerequisites Roles required to perform this action : Organization Owner Organization Admin Configure SAML with CyberArk Sign in to the CyberArk admin console. Click Web Apps under Apps in the left pane. Click Add Web Apps, then search for "Zoho". ...
                                                                                                                                • Use custom expressions as Name ID for SAML apps

                                                                                                                                  Once you enable and configure SAML SSO for your apps in Zoho Directory, Zoho Directory will authenticate your users into those apps. During authentication, Zoho Directory will pass a value called Name ID to the apps. The Name ID matches user ...
                                                                                                                                • Custom authentication with Microsoft Entra ID

                                                                                                                                  Prerequisites Roles required to perform this action: Organization Owner Organization Admin Admin account in Microsoft Entra ID Custom authentication with Microsoft Entra ID enables SAML-based single sign-on (SSO) from Microsoft Entra ID to Zoho. Once ...
                                                                                                                                • Custom authentication with miniOrange

                                                                                                                                  Prerequisites Roles required to perform this action : Organization Owner Organization Admin Configure SAML with miniOrange Sign in to the miniOrange admin console. Click Apps in the left menu, then click Add Application. In the Choose Application ...
                                                                                                                                • Custom authentication with PhenixID

                                                                                                                                  Prerequisites Roles required to perform this action : Organization Owner Organization Admin Custom authentication with PhenixID: Custom authentication with PhenixID enables you and your employees to sign in and access Zoho Directory using your ...
                                                                                                                                  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