> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Configuration

> Configurable parameters for the hosted onboarding page: branding, colors, and validation rules — in the gu1 KYC API for identity verification flows.

## Hosted Onboarding Page

The quickest way to build optimized identity verification pages, hosted on Gu1.

Our hosted solution is a secure, fully customizable, hosted KYC and identity verification page that enables you to verify your clients quickly without any code.

<Info>
  **Custom configuration**\
  To apply any of the parameters described on this page, please contact the Gu1 technical team. They will configure the hosted page and validations according to your needs.
</Info>

***

## Page Customization Parameters

You can customize the onboarding page using these parameters:

| Parameter                  | Description                                    |
| -------------------------- | ---------------------------------------------- |
| `domain`                   | The web page can be hosted on your own domain. |
| `lang`                     | The default page language: `en`, `es`, `pt`.   |
| `headersColor`             | Hex code for the headers color.                |
| `paragraphsColor`          | Hex code for the paragraphs color.             |
| `supportTextsColor`        | Hex code for the support texts color.          |
| `backgroundColor`          | Hex code for the background color.             |
| `pillsColor`               | Hex code for the pills color.                  |
| `progressBarColor`         | Hex code for the progress bar color.           |
| `primaryButtonColor`       | Hex code for the primary button color.         |
| `secondaryButtonColor`     | Hex code for the secondary button color.       |
| `selectorColor`            | Hex code for the selector color.               |
| `primaryButtonTextColor`   | Hex code for the primary button text color.    |
| `secondaryButtonTextColor` | Hex code for the secondary button text color.  |
| `borderRadius`             | Web border radius. Number between 0 and 50.    |
| `icon`                     | The page icon (favicon).                       |
| `logo`                     | The main logo.                                 |

***

## Validation Parameters

You can customize the validations using these parameters:

| Parameter                     | Description                                                                                                                                      |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Exclude By Age**            | Decline automatically all sessions performed by users under a certain age. Number between 1 and 100.                                             |
| **Capture Method**            | Select allowed methods for images: **Camera**, **Upload**, or **Both**.                                                                          |
| **Duplicated users**          | When a user has previously approved documents from the same application, you can set an automatic rule: **Approve**, **Review**, or **Decline**. |
| **QR / barcode**              | If a barcode or QR code was expected in the document but couldn't be read: **Approve**, **Review**, or **Decline**.                              |
| **MRZ not valid**             | When a Machine-Readable Zone (MRZ) is expected in the document but cannot be read: **Approve**, **Review**, or **Decline**.                      |
| **Expiration date**           | When a document's expiration date is expected but cannot be read or is in an invalid format: **Approve**, **Review**, or **Decline**.            |
| **Invalid validation**        | When we are unable to validate a date, detect a document number, or accurately recognize the document: **Review** or **Decline**.                |
| **Invalid document liveness** | When we are unable to validate document liveness: **Approve**, **Review**, or **Decline**.                                                       |
| **Address not processed**     | When the address on the document could not be found or geolocated (e.g. invalid or missing address): **Approve**, **Review**, or **Decline**.    |

***

## How to Get the Onboarding Page URL

1. **Create a Person** — Use the [Create Person](/en/api-reference/person/create) API.
2. **Create a Session** for that Person — Use the [Create Validation](/en/use-cases/kyc/create-validation) (or equivalent) API to create a session.
3. **Get the `sessionUrl`** from the response.
4. Share the `sessionUrl` with your client so they can complete verification on the hosted page.