Hanzo
PlatformHanzo IAMApplications

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.

step4_result2.png

Background image

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

step1_start.png step1_backgroune_url.gif

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>

![step2_form_css.gif](/img/application/ui-customization/step2_form_css.gif)

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

![step2_end.png](/img/application/ui-customization/step2_end.png)

## 3. Panel position

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

![step3_position.png](/img/application/ui-customization/step3_position.png)
![step3_end.png](/img/application/ui-customization/step3_end.png)

## 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.

![enable_side_panel.png](/img/application/ui-customization/step4_enable_side_panel.png)

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>

![step4_modify_CSS.gif](/img/application/ui-customization/step4_modify_CSS.gif)

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

![step4_result2.png](/img/application/ui-customization/step4_result2.png)

## 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

On this page