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

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.

.

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.

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.

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.