UX Guide
▶️ OneID Button
Style the button to your branding to avoid discontinuity and loss of confidence in the flow users need to take.
OneID® is the fastest and only truly digital identity verification in the UK. With OneID®, your customers can complete a journey without needing to have their government identity documents in their hand - that means more conversion for your business. But your customers might not know the value for them unless they're told beforehand.
We have created different layout options for you. We recommend using our enhanced button for improved visuals providing a simpler user experience:

If you can't use our enhanced button, we suggest following the layout structures shown below.

🔖 Add your logo
From an end-user perspective, the transition between two different brands risks creating a disjointed and confusing user experience, which might lead to abandonment. By adding your logo to OneID®, users are reassured they are in the right place.
Follow these steps to ensure your logo is added correctly:

Prepare Your Logo:
- Ensure it's either SVG or PNG format. SVG is preferred for the best resolution.
- The designated are for your logo is 36px high by 200px wide. If using PNG, make sure it is at least this size for good resolution.
Add the Logo:
- Email your logo to askus@oneid.uk and we’ll add it for you.
⏎ Return message
First-time users might be unsure whether their document-free verification was successfully completed or not. To clarify this, we have created standard messages that you can add to your Return URL::
Success
Thank you for verifying your identity. You can now continue to [next steps].
Failure and/or Error:
- Unfortunately we could not verify your [identity/age/details]. Please continue to [alternative method / next step].
- Unfortunately we could not verify your [identity/age/details] through your [bank/mobile network/document/oneid]. Please continue to [alternative method / next step].
🗂️ Layouts
- Redirect vs Pop-up
To optimise the usability of our products in different screen sizes, all mobile journeys are always presented using our redirect layout. Desktop journeys can be set as redirect or pop-up.
We recommend the redirect format if:
- Your user journey is part of a multi-flow process, you might want your customers to start their verification from a link sent to their email or SMS. In that case, redirect is the best option. For example, as part of a tenancy application you send an email asking the applicant to verify their identity details.

We recommend the pop-up layout if:
- Your user journey is a single-flow process where users start OneID® from a button in your page, a pop-up provides a smoother transition without disconnecting users from the action they need to take. For example, if users are asked to verify their identity to access a document or service within your platform.

We recommend the pop-up layout if:
- Your user journey is a single-flow process where users start OneID® from a button in your page, a pop-up provides a smoother transition without disconnecting users from the action they need to take. For example, if users are asked to verify their identity to access a document or service within your platform.
- Standard vs white label
- Standard vs white label
Our standard journey reduces discontinuity whilst mentioning OneID in strategic decision-making points. As OneID acts as a facilitator between you and your customer's bank-held information, banks will ask users to share their data with OneID. For that reason, OneID is mentioned when handing-off users to their bank.
However, we understand your business might need the OneID technology only. Our white-labelled journey minimise OneID's references from the user-journey. If you choose this format, please note that you will be need to collect the T&Cs and Privacy Notice consent in your flow.
Customisation
Currently, you can customise the flow by:
- Replacing the OneID logo with your own;
- Removing mentions of OneID from the user journey.
We don't currently support full brand customisation. If full white-label branding is a requirement for your integration, please contact a member of our team to discuss potential solutions.
Terms & Conditions Positioning
Regardless of which verification method you're integration, White label customers are required to incorporate OneID's T&Cs into their user flow, before users reach the OneID verification process.

Bank verification flow
White-label flows integrating OneID’s bank verification skip the default OneID introduction screen and start directly at the bank selection interface, unless you choose to offer users an alternative verification method. This approach allows your business to introduce the bank verification step in a way that fits your brand and user experience.
It's important to note that when users reach their bank's interface, they will still be asked - by the bank - to share their data with OneID. To minimise the risk of user drop-off at this stage, we recommend proactively informing users about this step in your pre-verification messaging, at a time and place that fits naturally within your flow.
