> For the complete documentation index, see [llms.txt](https://docs.1kosmos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1kosmos.com/authentication/admin-portal/settings/branding-customization.md).

# Branding Customization

***

### Overview

Every customization below starts the same way: log in to your tenant as a community administrator, go to **Settings > Branding**, make your changes, and click **Save**.

| What you can customize                       | Jump to                           |
| -------------------------------------------- | --------------------------------- |
| Login page (experience, labels, logo, links) | [Login page](#login-page)         |
| Central logo in the QR code                  | [QR code](#qr-code)               |
| Background image layout                      | [Image layout](#image-layout)     |
| Sign-in page colors                          | [Sign-in colors](#sign-in-colors) |
| Help button on the login page                | [Help button](#help-button)       |

### Login page

In the **Login page branding** section, shape how users first experience sign-in:

* **Choose the experience** — **1 - QR code** (default) shows a QR code users scan with the 1Kosmos mobile app to log in without a password; **2 - Username** shows a username box, after which users complete a password and OTP, or a push notification.
* **Hide username tab** — select **Hide username tab from the display** to remove the **Username** tab (users can then no longer log in with a username).
* **Custom labels** — replace the default **Sign In** label (e.g., *Welcome to 1Kosmos*) and the default username label (e.g., *Enter your corporate ID*).
* **Custom hyperlink** — turn on **Enable Customize hyperlink text & URL**, then enter display text and an optional destination URL. A valid `http://`/`https://` URL redirects users; otherwise the default mobile app download links are used. This replaces the default *Don't have the app? iOS / Android* links; disabling restores them, and re-enabling resets previously entered values.
* **Custom app download text** — turn on **Enable Customize Mobile App download text** and enter your own message to replace the default download text.
* **Disclaimer** — add your organization's disclaimer, shown at the bottom of the sign-in page.
* **Community Logo** — click **Upload** to add your logo.

{% hint style="info" %}
**Note:** The logo must be PNG, JPG, or GIF and no larger than 2 MB.
{% endhint %}

### QR code

In the **QR code customization** section, brand the central logo and colors of the QR code:

* **Corner Square Color** — set the corner square color (default `#1B0B39`).
* **Dots Color** — set the dots color (default `#1B0B39`).
* **Central logo** — click **Upload** to add an image.

{% hint style="info" %}
**Note:** The central logo must be a PNG or JPG under 10 KB; recommended size is 35px × 35px.
{% endhint %}

### Image layout

In the **Image Layout** section, set the background image for your sign-in page:

* **Upload Image** — add an image (JPG, PNG, or GIF; recommended resolution 1920×1080; max 2 MB).
* **Display style** — choose **Full width Background** (image across the entire page) or **Left Panel** (image on the left panel only).
* **Left Panel Background Color** — select a background color.

### Sign-in colors

In the **Left Panel** section, fine-tune the colors of individual sign-in page components:

Background Color · Title Text Color · Primary Button Color · Tabs Text Color · Links Color · Footer Color.

### Help button

Give users a way to get unstuck. Toggle the **Help Button on Login Page** slider to display a **Help** button in the login page footer, where users can view customizable helpdesk information such as support numbers and email addresses.

Once enabled, customize the **Help Button background color**, **Help Button title**, **Content Window title**, and **Content** (the on-screen tip shows exactly what's customizable). After saving, test it by logging out and clicking the **Help** button at the bottom-right of your tenant login page.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.1kosmos.com/authentication/admin-portal/settings/branding-customization.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.