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

# Customizing Release0 Agent appearance

> Customize the appearance of your Release0 agent, including templates, chat bubbles, and CSS. This guide provides an overview of the Theme section, including how to change the agent's look and feel, customize chat bubbles, and apply custom CSS styles.

The **Theme** section allows you to customize the appearance of your Agent.

## Template

The **Template** section provides a variety of pre-designed themes to choose from. You can select a template that best fits your needs and customize it further.

## Global

This section enables you to:

* Enable or disable the Agent branding.
* Change the font used by your Agent.
* Customize the background of your Agent.
* Show the Agent's flow progress bar.

<Frame style={{ maxWidth: '400px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/Q5qvhj8Soug3VWoB/images/theme/global.png?fit=max&auto=format&n=Q5qvhj8Soug3VWoB&q=85&s=ff46a0945f5f30266092c5306fc28a47" alt="Agent Global" width="371" height="344" data-path="images/theme/global.png" />
</Frame>

## Chat container

This section allows you to personalize the chat window's appearance. You can adjust the following elements:

* Text color
* Max width
* Max height
* Background type
* Border
* Roundness

<Frame style={{ maxWidth: '400px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/YWq2zuUGbHzFURAJ/images/theme/chat-container.png?fit=max&auto=format&n=YWq2zuUGbHzFURAJ&q=85&s=97184e99244780426ebc25d358a6c1be" alt="Chat container" width="373" height="548" data-path="images/theme/chat-container.png" />
</Frame>

## Agent Bubble

This section allows you to customize the appearance of the Agent's chat bubble. You can adjust the following elements:

* Show or hide Agent's avatar
* Avatar image
* Text color
* Background color
* Background type
* Border
* Roundness
* Opacity

<Frame style={{ maxWidth: '400px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/YWq2zuUGbHzFURAJ/images/theme/agent-bubble.png?fit=max&auto=format&n=YWq2zuUGbHzFURAJ&q=85&s=d0de24b6c8037e5acbbe6078b502acae" alt="Agent bubble" width="364" height="537" data-path="images/theme/agent-bubble.png" />
</Frame>

To change the avatar image:

1. Click on the toggle to show the avatar.
2. Click on the agent avatar within the **Chat** section.
3. Upload or select a new image.

<Frame style={{ maxWidth: '400px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/YWq2zuUGbHzFURAJ/images/theme/change-agent-avatar.png?fit=max&auto=format&n=YWq2zuUGbHzFURAJ&q=85&s=587d13f2e332b0e735c5441935664c7e" alt="Change agent avatar" width="610" height="629" data-path="images/theme/change-agent-avatar.png" />
</Frame>

Once changed, you can preview the changes in the preview pane and see your chat agent in action.

<Frame style={{ maxWidth: '600px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/YWq2zuUGbHzFURAJ/images/theme/agent-avatar.png?fit=max&auto=format&n=YWq2zuUGbHzFURAJ&q=85&s=634841f5cdf8dee9af27824b235e5f3e" alt="Agent avatar" width="818" height="435" data-path="images/theme/agent-avatar.png" />
</Frame>

## Guest Bubble

This section allows you to customize the appearance of the user's chat bubble. You can adjust the following elements:

* Show or hide user's avatar
* Avatar image
* Text color
* Background color
* Background type
* Border
* Roundness
* Opacity

<Frame style={{ maxWidth: '400px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/Q5qvhj8Soug3VWoB/images/theme/guest-bubble.png?fit=max&auto=format&n=Q5qvhj8Soug3VWoB&q=85&s=3d22eb916c24553a0259eb35bd281481" alt="Guest bubble" width="369" height="528" data-path="images/theme/guest-bubble.png" />
</Frame>

To change the avatar image:

1. Click on the user's avatar within the **Chat** section.
2. Upload or select a new image.

<Frame style={{ maxWidth: '400px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/YWq2zuUGbHzFURAJ/images/theme/change-guest-avatar.png?fit=max&auto=format&n=YWq2zuUGbHzFURAJ&q=85&s=062c7d0def011e53ad3c320a994c7ac1" alt="Change agent avatar" width="610" height="638" data-path="images/theme/change-guest-avatar.png" />
</Frame>

Once changed, you can preview the changes in the preview pane and see your chat agent in action.

<Frame style={{ maxWidth: '600px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/Q5qvhj8Soug3VWoB/images/theme/guest-avatar.png?fit=max&auto=format&n=Q5qvhj8Soug3VWoB&q=85&s=c91ce1b90a82a7803ce0340c06fb9624" alt="Agent avatar" width="795" height="221" data-path="images/theme/guest-avatar.png" />
</Frame>

## Buttons

This section allows you to customize the appearance of the buttons. You can adjust the following elements:

* Text color
* Background color
* Background type
* Border
* Roundness
* Opacity
* Shadow
* builder

<Frame style={{ maxWidth: '400px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/YWq2zuUGbHzFURAJ/images/theme/buttons.png?fit=max&auto=format&n=YWq2zuUGbHzFURAJ&q=85&s=a1ac2b9070eb42f8a959f1cf17848d48" alt="Buttons" width="370" height="635" data-path="images/theme/buttons.png" />
</Frame>

## Inputs

This section allows you to customize the appearance of the inputs. You can adjust the following elements:

* Text color
* Placeholder color
* Background color
* Background type
* Opacity
* Border
* Roundness
* Shadow
* builder

<Frame style={{ maxWidth: '400px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/Q5qvhj8Soug3VWoB/images/theme/inputs.png?fit=max&auto=format&n=Q5qvhj8Soug3VWoB&q=85&s=b43633a0d0e3dca99d05ab4b13bdf6b1" alt="Inputs" width="371" height="614" data-path="images/theme/inputs.png" />
</Frame>

## Typing

This section allows you to customize the typing behaviour of your agent.  You can adjust the following elements:

* Typing emulation:
  * Enable or disable typing emulation.
  * Adjust the typing speed (in milliseconds).
  * Adjust the maximum delay between messages (in seconds)
  * Adjust the delay before the first message is sent (in seconds).

<Frame style={{ maxWidth: '400px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/Q5qvhj8Soug3VWoB/images/theme/typing.png?fit=max&auto=format&n=Q5qvhj8Soug3VWoB&q=85&s=949b753543b298e19be69c1f27f5409a" alt="Typing" width="373" height="325" data-path="images/theme/typing.png" />
</Frame>

## Custom CSS

For advanced customization, you can add your own CSS styles.

<Frame style={{ maxWidth: '400px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/Q5qvhj8Soug3VWoB/images/theme/custom-css.png?fit=max&auto=format&n=Q5qvhj8Soug3VWoB&q=85&s=bce8e90f5197ed2fdc512f1e59d179dd" alt="Custom css" width="370" height="343" data-path="images/theme/custom-css.png" />
</Frame>

### Inspecting Elements for Custom CSS

1. Navigate to the **Theme** page.
2. Right-click on the agent or the specific element you want to modify.
3. Select **Inspect** to view and target the element's CSS.

### Example: Rounded Buttons with Gradient Colors

To create buttons with rounded corners and a gradient color, add the following CSS:

```css theme={null}
.agent-button {
  border-radius: 40px;
  background-image: linear-gradient(to right, #e052a0, #f15c41);
  border: none;
}
```

### Example: Configuring RTL chat

You can configure the chat to be displayed in RTL (Right-to-Left) format by adding the following CSS:

```css theme={null}
.agent-container {
  direction: rtl;
}

.agent-avatar-container {
  margin-right: 0;
  margin-left: 0.5rem;
}

.guest-container {
  margin-left: 0;
  margin-right: 50px;
}
```

<Frame style={{ maxWidth: '600px' }}>
  <img src="https://mintcdn.com/release0-13d037a7/wBCYRe8zYj7SPCzD/images/guides/rtl.gif?s=81f31ade3aa6e4258ac0f8716247e397" alt="Custom CSS RTL" width="1220" height="860" data-path="images/guides/rtl.gif" />
</Frame>

### Example: Customize a Single Button’s Color

You can customize the color of an individual button by targeting its `data-itemid` attribute. For instance:

```css theme={null}
[data-itemid='cl3iunm4p000f2e6gfr8cznnn'] {
  background-color: gray;
  border-color: gray;
}
```

#### Finding the Button's `data-itemid`

1. Right-click on the button you want to customize.
2. Select **Inspect** to view the `data-itemid` attribute in the HTML.

> **Note**: Always test your customizations in a staging environment before applying them to your live Agent.

***

### Validation and Testing

Before applying your customizations:

* Ensure that the custom CSS is properly formatted.
* Test changes across different devices and browsers for consistency.
* Verify that all visual components work as intended.
