# Customize how the Sales Agent looks on your site

> In Agentic › Sales Agent › Customize, set the chat title and invite message, the launcher shape on desktop and mobile, the notification bar, how products show in replies and the chat colors, then save.

The **Customize** tab decides what the Sales Agent looks like on your site: the name in the chat window, the line that invites shoppers to ask, the launcher shape, the notification bar, how products show in replies, and the colors. This guide walks through every setting and shows the result on a page of a site. To choose the pages where the chat shows, see [Choose where the Sales Agent appears](https://releva.ai/documentation/guides/sales-agent/choose-where-the-sales-agent-appears/). For how the Sales Agent works, read [How the Sales Agent works](https://releva.ai/documentation/learn/sales-agent/how-the-sales-agent-works/).

## Before you start

* The Sales Agent is switched on for your shop. Until then, the page has no tabs. Releva turns the Sales Agent on for your shop the first time: only a Releva super admin can make the first switch-on, so contact Releva.
* To use your own brand colors, confirm your brand first, in the How-To Guide step **Confirm your brand**. See [Get started with Releva](https://releva.ai/documentation/guides/get-started/get-started-with-releva/).
* For your own launcher icon, have the image ready as a web address (http or https), or upload it to **Assets**.

## Steps

1. In the sidebar, open **Agentic** and select **Sales Agent**.

   ![The Agentic panel of the sidebar with Sales Agent highlighted](https://releva.ai/documentation/_astro/step-1.B41nlj4-_1uHOW0.webp)

2. Select the **Customize** tab.

   ![The Sales Agent page with the Customize tab highlighted](https://releva.ai/documentation/_astro/step-2.0R66cAFd_Z1B6mjQ.webp)

3. In **Bot Title**, enter the name shown in the chat window header. In **Invite Message**, enter the line that invites shoppers to ask.

   The invite message shows on the line bar, in the notification bar and in the chat’s message box. The **Default / Fallback** row is used for every language without its own row. To add another language, choose it in **Select a language** and select **Add Language**.

   ![Bot Title set to Shopping Assistant and Invite Message set to Ask me about sizes, delivery or returns](https://releva.ai/documentation/_astro/step-3.DEvuljas_ZrOpP5.webp)

4. Optional: in **Bubble Icon**, paste the web address of your own icon, or select **Browse** to pick an image from **Assets**.

   Your icon replaces the Releva icon everywhere in the chat. Leave the field empty to keep the Releva icon.

   ![The Bubble Icon field with the Browse button highlighted](https://releva.ai/documentation/_astro/step-4.BaoBPj-1_1MOtvM.webp)

5. In **Widget Position**, choose **Right** or **Left**: the side of the screen where the launcher and the chat window sit.

   ![The Widget Position list open with Right and Left](https://releva.ai/documentation/_astro/step-5.CgAgu4SO_ZohQ6S.webp)

6. In **Product Results Display**, choose how products show in replies: **List** stacks them, **Carousel** puts them side by side so shoppers swipe through them.

   ![The Product Results Display list highlighted](https://releva.ai/documentation/_astro/step-6.CquUOkuN_ZiMgY4.webp)

   On your site, with **Widget Position** set to **Left** and **List**:

   ![A page with the chat window on the left and two products stacked in the reply](https://releva.ai/documentation/_astro/step-6.D1j2cS2T_Z12eGFO.webp)

   With **Carousel**:

   ![The chat window on the right with the products side by side in a carousel](https://releva.ai/documentation/_astro/step-7.WttiJJr5_kI9AU.webp)

   Buttons on product cards, such as **Add to cart**, show only when Releva has set them up for your shop.

7. Optional: turn on **Notification Bar** to show a short message above the launcher before shoppers open the chat.

   Releva chooses the message for each shopper, for example a new or a returning visitor, in the language of the page.

   ![The Notification Bar switch highlighted](https://releva.ai/documentation/_astro/step-7.DxESUVOc_Z29VPEO.webp)

8. Set **Notification Delay (seconds)**, the time after the page loads before the bar shows (1 to 60). Turn on **Notification Send Button** to show the send button in the bar only after the shopper types; while the box is empty, the bar shows a × to close it.

   ![Notification Delay set to 8 and the Notification Send Button switch highlighted](https://releva.ai/documentation/_astro/step-8.C7V03n9J_9XAG3.webp)

   On your site, the bar opens by itself above the launcher:

   ![A page with the notification bar Hello! Need help finding something? above the line bar](https://releva.ai/documentation/_astro/step-5.BkBIJijB_1BLHBU.webp)

9. Under **Colors**, choose where the chat takes its colors from. **Releva default** keeps Releva’s colors. The **Preview** on the right shows the result as you change it.

   With **Releva default**, you can turn on **Own main color** and pick a **Main color** for the launcher, the shopper’s messages, the send button and links.

   ![The Colors section with Releva default selected and the preview on the right](https://releva.ai/documentation/_astro/step-9.NAyrxtkP_Z2k1OPd.webp)

10. To match your site, select **Brand Identity**.

    The chat then uses the colors of your confirmed Brand Identity and follows them when you change them there. **Brand Identity** can be selected only when your brand colors are confirmed.

    ![Brand Identity highlighted in the Colors control](https://releva.ai/documentation/_astro/step-10.BN801XU0_Z1G5X10.webp)

11. To change single colors, select **Custom**, then set each color: **Main color**, **Chat window**, **Conversation**, **Text** and **Muted text**.

    Colors you do not change keep following your brand. A warning shows when text is hard to read on its background; select **Fix** to use a readable color, or **Reset** to go back to the brand color.

    ![The Colors section with Brand Identity selected, listing each color and where it comes from, and Custom highlighted](https://releva.ai/documentation/_astro/step-11.D83nVKRe_rtGrb.webp)

12. In **Appearance**, choose **Light**, **Dark** or **Match visitor’s device**.

    **Match visitor’s device** shows the dark chat window to shoppers whose phone or computer is set to dark mode. With **Dark** or **Match visitor’s device** and **Custom** colors, a **Light** / **Dark** switch above the colors lets you set each side. The dark **Main color** follows the one you set on **Light**.

    ![Appearance with Match visitor’s device highlighted](https://releva.ai/documentation/_astro/step-12.CPbEgE8-_Z10mCTf.webp)

13. In the preview, select **Dark** to check the dark chat window before you save.

    ![The preview showing the chat window in dark colors](https://releva.ai/documentation/_astro/step-14.C8DUzHqy_wzC6r.webp)

    On your site, the dark chat window looks like this:

    ![A page with the chat window in dark colors and products in a carousel](https://releva.ai/documentation/_astro/step-8.DcJBiK2w_1TH4HT.webp)

14. Under **Launcher (line / bubble)**, choose the launcher shape in **Launcher on Desktop** and **Launcher on Mobile**:

    * **Auto (line, bubble on scroll)**: the line bar, which turns into the bubble while the shopper scrolls.
    * **Line bar**: a bar with your invite message at the bottom of the page.
    * **Bubble**: a round button in the corner.

    ![Launcher on Mobile highlighted under Launcher (line / bubble)](https://releva.ai/documentation/_astro/step-15.HBNfZBTz_2hgvJM.webp)

    The line bar and the bubble on a desktop page:

    ![A page with the line bar Ask me anything… at the bottom right](https://releva.ai/documentation/_astro/step-1.DUWNra48_1tliXJ.webp)

    ![A page with the round bubble at the bottom right](https://releva.ai/documentation/_astro/step-2.C3sN2tRn_kmxlE.webp)

    The line bar and the bubble on a phone:

    ![A phone screen with the line bar across the bottom](https://releva.ai/documentation/_astro/step-1.BhCqCavs_ZtpwOv.webp)

    ![A phone screen with the round bubble at the bottom right](https://releva.ai/documentation/_astro/step-2.v_pPkzyt_Z1wRUgU.webp)

15. Optional: turn on **Collapse Control** to put a × on the line bar. It folds the line into the bubble for the rest of the page; it does not hide the chat.

    ![The Collapse Control switch highlighted](https://releva.ai/documentation/_astro/step-16.CjJcHNiL_ZGdzr8.webp)

    On desktop the × shows when the shopper points at the line bar; on phones it always shows:

    ![A page with the line bar and its × showing](https://releva.ai/documentation/_astro/step-3.DimSLM4c_SS4nw.webp)

    ![A phone screen with the line bar and its × on the right](https://releva.ai/documentation/_astro/step-3.DTVUri2S_2jpdY.webp)

16. Optional: in **Launcher Offset (px)**, set **Horizontal (X)** and **Vertical (Y)**, the distance of the launcher from the screen corner (0 to 200, 24 by default). The offset applies on desktop and mobile.

    ![Launcher Offset with Horizontal (X) set to 32](https://releva.ai/documentation/_astro/step-17.kmpqggi0_ZrApYh.webp)

    With both set to 60, the bubble sits further from the corner:

    ![A page with the bubble further from the bottom right corner](https://releva.ai/documentation/_astro/step-4.odOL_knm_ZmeAnz.webp)

17. Select **Save**.

    Nothing reaches your site until you save.

    ![The Save button highlighted at the bottom of the Customize tab](https://releva.ai/documentation/_astro/step-18.BoFJg1mQ_193UWg.webp)

## Check it worked

* The button at the bottom of the page reads **Saved**.
* Open a page of your site with debug mode (`?rlv_mode=debug`) and reload it. The launcher shows in the shape, position and colors you chose; open it to check the title and colors. Debug mode shows the chat even while the **Chat Bot** switch is off. See [Check Releva on your site with debug mode](https://releva.ai/documentation/guides/on-your-site/check-releva-on-your-site-with-debug-mode/).
* To check the mobile launcher, open the page on a phone, or narrow the browser window to phone width.

You do not need to send a message to check the look: the launcher and the chat window with your welcome message are enough.

## Troubleshooting

**Brand Identity cannot be selected under Colors.** Your brand colors are not confirmed yet. The tab shows a link to **Set up Brand Identity** or **Review and confirm**. Confirm your brand, then come back.

**A warning says color pairs are hard to read.** Some text is hard to read on its background. Saving still works, but shoppers may not read it well. Select **Fix** next to the color, or pick a darker or lighter color.

**The Bubble Icon field says “Enter a valid http(s) image URL”.** Paste a full web address that starts with `http://` or `https://`, or select **Browse** and pick the image from **Assets**.

**The notification bar never shows.** Check that **Notification Bar** is on and saved, and wait for the **Notification Delay**. Once a shopper has opened the chat during a visit, the bar does not come back in that visit; to test it again, use a new private browser window.

**The chat sits under another element of your site, such as a cookie banner or a sticky footer.** Change **Launcher Offset (px)** to move the launcher. If the chat window itself is covered, contact Releva support.

**My changes do not show on my site.** Select **Save** and reload the page. If the chat does not show at all on a page, check the URL filter: see [Choose where the Sales Agent appears](https://releva.ai/documentation/guides/sales-agent/choose-where-the-sales-agent-appears/).

## Fine-tune with CSS on your site

This is optional and for developers. The settings above cover most shops. To go further, add CSS to your own site:

* Custom properties named `--releva-*` change the chat’s colors and sizes, for example `--releva-primary`, `--releva-background`, `--releva-surface`, `--releva-text`, `--releva-text-muted` and `--releva-radius-lg`. Set on your page, they win over the colors you chose in **Customize**.
* `::part()` selectors style single parts of the chat. The chat window lives in `#chat-bot-wrapper` and the bubble in `.chat-bot-launcher-host`. Parts of the chat window: `header`, `input`, `send-button`, `message` (with `message-bot` and `message-user`), `message-feedback`, `product-card`, `product-card-item`, `product-card-link`, `product-card-actions`, `chat-actions` and `chat-action`. Part of the bubble: `launcher`.

```plaintext
:root {
  --releva-primary: #0a7d2c;
}


#chat-bot-wrapper::part(header) {
  background: #fff7ed;
}


.chat-bot-launcher-host::part(launcher) {
  border-radius: 12px;
}
```

Check the result with debug mode on a test page before you publish the CSS.

## Next steps

* [Choose where the Sales Agent appears](https://releva.ai/documentation/guides/sales-agent/choose-where-the-sales-agent-appears/): keep the chat off pages such as checkout.
* [Set up the Sales Agent welcome message](https://releva.ai/documentation/guides/sales-agent/set-up-the-sales-agent-welcome-message/): write what shoppers read first when they open the chat.
* [Turn the Sales Agent on or off](https://releva.ai/documentation/guides/sales-agent/turn-the-sales-agent-on-or-off/): show the chat to your shoppers once it looks right.