Configure the GOV.UK Design System Service Portal Registration and Login pages

  • Release version: Australia
  • Updated June 1, 2026
  • 2 minutes to read
    • Summarize
    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 Configure the GOV.UK Design System Service Portal Registration and Login pages

    The GOV.UK Developer Toolkit offers default registration and login pages for the GOV.UK Design System (GDS) Service Portal that comply with GOV.UK design standards. These pages can be used as provided or customized by configuring the default widgets to meet your specific needs. The solution ensures a consistent, accessible user experience aligned with GOV.UK style guidelines.

    Show full answer Show less

    Portal Landing Page

    Non-authenticated users accessing the portal homepage see options to log in or register. This landing page resembles the portal homepage but excludes widgets visible only to authenticated users. It includes a login button in the header and a registration link for new users. Upon login or registration, users are redirected to the authenticated homepage, which displays widgets requiring authentication.

    You can configure this landing page to show widgets or components that do not require authentication, enabling a tailored experience for all visitors. Role-based access management allows control over which users see specific pages or widgets.

    Login Page

    The default login page features the UK GDS Login widget, which authenticates users based on their User [sysuser] credentials. Successful login redirects users to the authenticated portal homepage. The login page is customizable with additional widgets, and you can define specific login scenarios to redirect users to different pages post-authentication.

    Registration Pages

    The default registration page presents options for different user types—constituent, business contact, or new business—each linking to a tailored registration form:

    • Constituent Registration: Captures personal details (email, name, phone, password) with terms and conditions acceptance.
    • Business Registration: Allows new business registration via a multi-section form, creating a business registration record.
    • Business Contact Registration: Enables registering as a business contact, creating a customer service registration record.

    All registration forms follow GOV.UK form patterns featuring single-column layouts, inline validation, error summaries, reCAPTCHA integration, and terms and conditions checkboxes to ensure usability and security.

    Customization and Configuration

    ServiceNow customers can customize widgets on login and registration pages using the Service Portal Designer. This flexibility allows adapting the user interface and workflow to organizational requirements while maintaining compliance with GOV.UK design principles.

    For managing access and modifying pages or widgets, guidance is provided on role-based access control and page editing within the Service Portal Designer.

    The GOV.UK Developer Toolkit provides default GDS Service Portal registration and login pages that are complaint with GOV.UK design standards. You can use these pages as-is, or you can configure the default widgets to meet your needs.

    Portal Landing page

    When accessing the portal homepage as a non-authenticated user, users are displayed the option to log in or register for the GDS Service Portal. This homepage is the same page as the portal homepage, albeit without any of the widgets that would be shown to an authenticated user. This page contains a login button in the header, and a link to the registration page for users that don't have a record in the system. On login or registration, the page redirects users to the portal homepage view for logged-in users, that is populated with widgets that display various sources of information that requires authentication.
    Note:
    You can configure this page to display widgets or components that don't require authentication. To configure access to widgets or pages, see Manage role-based access to pages and widgets in GOV.UK Design System Service Portal.
    .

    GDS Portal Branded Landing page.

    Login Page

    When a user selects Log in on this landing page, they are directed to the default GDS Service Portal login page. The default login page (uk_gds_login) contains the UK GDS Login widget, which provides a field for users to enter their credentials for log-in to the GDS Service Portal. This widget uses credentials from the User [sys_user] record, and redirects users to the portal homepage view for logged-in users upon authentication.

    GDS Portal login page.

    This login page can be customized using widgets, and you can define different login scenarios that will redirect user to certain pages on authentication. For more information on customizing login scenarios in a portal, see Define login scenarios.

    Registration Pages

    When a user selects Register on this page, the default GDS Service Portal registration page (uk_gds_register) displays. The default registration page contains the following widgets:
    • UK GDS Registration Content widget, which displays a card showing a heading, subtitle, and a list of benefits of registration for the portal.
    • UK GDS Registration Info widget, which displays registration type options ( constituent, business contact, new business). Selecting a type within this widget will navigate to the registration page for that type, each with distinct widgets or forms that can be customized or replaced.

    Authenticated users are redirected to the portal homepage.

    GDS Portal register page.

    The default Constituent registration page (uk_gds_constituent_register) contains the UK GDS Registration Request widget, which displays a field that captures email, first name, last name, phone (optional), password, and acceptance of the terms and conditions.

    The default business registration page (uk_gds_business_register) contains the UK GDS Business Registration widget, which displays a multi-section registration form allowing users to register a new business, and creates a sn_gsm_business_registration record.

    The default business contact registration page (uk_gds_business_contact_register) contains the UK GDS Business Contact Registration widget, which displays a "Create an account" form allowing users to register as a business contact, creating a sn_customerservice_registrationrecord.

    These pages and forms adhere to GOV.UK form patterns using single-column layout, inline validation via ukgds-error-message, error summary via ukgds-error-summary, reCAPTCHA, and a terms & conditions checkbox.

    For more information on how to edit widgets that appear on a page in the Service Portal Designer, see Configure the GOV.UK Design System Service Portal Pages. For more information on portal pages, see Create and edit a page using the Service Portal Designer.