Login UI customization
Customize the sign-in page: background, panel style, position, and side panel.
This guide walks through customizing your application’s sign-in page: background image, login panel style, position, and optional side panel.

Background image
The default background is white. Set Background URL to an image URL; the preview updates when the URL is valid.

Login panel style
Use Form CSS to style the login panel. Example:
<style>
.login-panel{
padding: 40px 30px 0 30px;
border-radius: 10px;
background-color: #ffffff;
box-shadow: 0 0 30px 20px rgba(0, 0, 0, 0.20);
}
</style>

:::tip
If **Form CSS** is empty, the editor may show a default; copy the content and paste it into the field, then save.
:::

## 3. Panel position
Use the position buttons to place the panel on the **Left**, **Center**, or **Right**.


## 4. Side panel
Enable **Enable Side Panel** so the form is centered with a side area. Edit **Side panel HTML** for the side content; start from the default template or customize it.

Example **Side panel HTML**:
```html
<style>
.left-model{
text-align: center;
padding: 30px;
background-color: #8ca0ed;
position: absolute;
transform: none;
width: 100%;
height: 100%;
}
.side-logo{
display: flex;
align-items: center;
}
.side-logo span {
font-family: Montserrat, sans-serif;
font-weight: 900;
font-size: 2.4rem;
line-height: 1.3;
margin-left: 16px;
color: #404040;
}
.img{
max-width: none;
margin: 41px 0 13px;
}
</style>
<div class="left-model">
<span class="side-logo"> <img src="https://cdn.hanzo.ai/img/iam-logo_1185x256.png" alt="Hanzo IAM" style="width: 120px">
<span>SSO</span>
</span>
<div class="img">
<img src="https://cdn.hanzo.ai/img/casbin.svg" alt="Hanzo IAM"/>
</div>
</div>
Refine the layout with **Form CSS** (e.g. `.login-panel`, `.login-form`):
```html
<style>
.login-panel{
border-radius: 10px;
background-color: #ffffff;
box-shadow: 0 0 30px 20px rgba(0, 0, 0, 0.20);
}
.login-form {
padding: 30px;
}
</style>

:::info
`.login-panel` and `.login-form` are the main container classes; target them in **Form CSS** for further customization.
:::

## Summary
Set **Background URL**, style **Form CSS**, choose **panel position**, and optionally enable and style **Side panel HTML**. See also:
- [Customize theme](/docs/organization/customize-theme) — primary color and border radius
- [Sign-up items table](/docs/application/signup-items-table)
- [Application config](/docs/application/config)How is this guide?
Last updated on