--- sourceDocument: Yokohama ServiceNow AI Platform user interface sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/platform-user-interface Release : - yokohama ft:locale : - en-US ft:publication_title : - Yokohama ServiceNow AI Platform user interface ft:clusterId : - platux bundleId : - platux workflow : - Platform --- # Login widget # Login widget {#ariaid-title1} Release version: Yokohama Updated January 30, 2025 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Login widget The Login widget is a fundamental component in your ServiceNow portal that manages user access by verifying credentials against the User \[sysuser\] records. It serves as the gateway for users to securely log in to your portal, either using their User ID and password or alternative authentication methods. Show full answer Show less ## Key Features * **Standard login:** Users enter their User ID and password as stored in their user records to access the portal. * **Forgot Password? link:** By default, the widget includes a link that directs users to reset their password via the Password Reset application. This link's visibility can be toggled using the `glide.security.forgotpassword.display.link` system property. The redirection page for password reset is controlled by the `glide.security.passwordreset.uri` system property. * **External user self-registration:** Users without accounts can self-register through a link on the login widget, enabling large-scale onboarding without administrator intervention. * **PIV/CAC authentication:** Supports certificate-based login using Personal Identity Verification (PIV) or Common Access Card (CAC) cards once the administrator activates and configures this authentication method. Users can register their cards and then log in using the card reader and dedicated login option. * **Instance options for customization:** You can configure the widget's appearance and layout on portal pages, including showing or hiding the background panel to enhance visibility and switching to an advanced layout that moves the Forgot Password? link and adds field labels. ## Practical Application for ServiceNow Customers ServiceNow customers can deploy the Login widget as-is for immediate user access control or clone and customize it to match specific business requirements. The widget's built-in support for password reset, self-registration, and certificate-based authentication streamlines user onboarding and enhances security. Administrators can tailor the widget's interface and behavior using instance options to improve user experience on their portals. To extend or modify the login experience, customers can manage widget instances and pages via the Service Portal Designer, enabling integration with broader portal workflows and branding. The login widget controls user access to your site. You can use this base system widget as-is in your portal or clone it to suit your own business needs. ## Using the widget {#login-widget__section_twy_z3b_5kb} Users log in to a portal by entering their credentials in the login widget. The widget uses credentials from the User \[sys_user\] record. In the User name field, the user enters the User ID from their user record. In the Password field, the user enters the password from their user record. Figure 1. Login widget The login widget by default includes a Forgot Password? link that enables users to reset their password using the Password Reset application. For more information about Password Reset configuration, see [Password Reset](https://www.servicenow.com/docs/access?context=password-reset-landing-page&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Note: When the user selects Forgot Password?, the system redirects the user to the page value specified in the glide.security.password_reset.uri system property. If you don't want to include the Forgot Password? link, set the glide.security.forgot_password.display.link system property to false. ## External user self-registration {#login-widget__section_x1g_zkb_5kb} External user self-registration enables a large group of users to register to a ServiceNow app without the help of an administrator. Users register to the app via a link at the bottom of the login widget screen that says ""Don't have an account? Register". For more information on external user self-registration, see [Enable external users to self-register to your ServiceNow instance](https://www.servicenow.com/docs/access?context=external-user-self-registration&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). ## PIV/CAC authentication {#login-widget__section_t4d_p35_4nb} With certificate-based authentication activated in your instance, users can register their Personal Identity Verification (PIV) or Common Access Card (CAC) card for Service Portal login. After self-registering their PIV/CAC card, a user can log in by inserting their card into a card reader and then selecting Login with PIV/CAC card on the login widget. Before a user can register their PIV/CAC card, an administrator must activate certificate-based authentication and then set up PIV/CAC authentication. For more information on this setup process, see [Personal Identity Verification (PIV) card or Common Access Card (CAC) based authentication](https://www.servicenow.com/docs/access?context=certificate-based-authentication&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). For more information on how a user self-registers their PIV/CAC card, see [Register your PIV/CAC card for Service Portal login](https://servicenow-prod.fluidtopics.net/L1PtsS9_qIrplxn~MGBZWw "Register your Personal Identity Verification (PIV) or Common Access Card (CAC) card so that you can log in to your organization's portal without entering a password."). ## Instance options {#login-widget__section_gpz_33x_j1b} Use the instance options to configure the login widget for a portal page. {#login-widget__table_ryr_frx_j1b__entry__2} | Field | Description | |-|-| | Show panel | Show or hide the panel that appears behind the login widget. The panel helps the widget stand out from the page background rather than blending in. | | Use Advanced View | Changes the widget layout. Adds the Forgot Password? link to the left of the Login button and adds field names for User name and Password instead of hint text. | [ ] {#login-widget__table_ryr_frx_j1b} **Related tasks** * [Create and edit a page using the Service Portal Designer](https://servicenow-prod.fluidtopics.net/x2gXWj4id21P6Zpk9NeShA#t_ConfigureAPage "Create or edit a page and use layouts to organize the columns that house the widgets.") * [Configure widget instances](https://servicenow-prod.fluidtopics.net/5W12O28oJneVtcGsqmlqKg "Create unique instances of widgets by configuring the options for each instance.") * [Clone a widget](https://servicenow-prod.fluidtopics.net/YyFPkPDFhu~i_CR5U5Adyg "Take advantage of existing code by cloning and editing an existing widget.")