# Customization

Customize the look and feel of Conversational Search to match your brand. All settings are available in the Alhena dashboard under **Integrations > Conversational Search > Settings**.

The settings page includes a live preview so you can see your changes in real time before saving.

<figure><img src="/files/JD6qWV4NjYwbJZ7BQmJM" alt=""><figcaption><p>Conversational Search settings page with live preview</p></figcaption></figure>

## Conversational Search Start Page

The start page is what customers see when Conversational Search first opens. It includes a heading, input field, and AI-generated starter questions.

<figure><img src="/files/gaG9CzAHZRMRvzmn6CeW" alt=""><figcaption><p>Conversational Search start page with heading, input field, and starter questions</p></figcaption></figure>

### Available Settings

| Setting                               | Description                                               | Default                             |
| ------------------------------------- | --------------------------------------------------------- | ----------------------------------- |
| **Page heading text**                 | The main heading displayed at the top of the start page   | `Chat to Find Your Perfect Product` |
| **Search input placeholder text**     | Placeholder text shown in the message input field         | `Send a message`                    |
| **Send button background color**      | Color of the send button in the input field               | `#4E4AFF`                           |
| **Page background color**             | Background color of the entire start page                 | `#F8FAFC`                           |
| **Number of starter questions**       | How many AI-generated starter questions to display (0–10) | `4`                                 |
| **Starter question background color** | Background color of the starter question chips            | `#EDEDFF`                           |
| **Starter question text color**       | Text color of the starter question chips                  | `#4E4AFF`                           |

### Starter Questions

Conversational Search automatically generates relevant starter questions based on your product catalog and knowledge base. These appear below the input field to help customers get started quickly.

You can control how many questions appear using the **Number of starter questions** setting (0 to hide them entirely, up to 10).

## AI Mode Chat Widget

The AI Mode chat widget is the conversational interface that appears when a customer starts a conversation from Conversational Search. This is where the back-and-forth conversation happens.

<figure><img src="/files/QUunVCLBDoHISQMgQVKB" alt=""><figcaption><p>AI Mode chat widget with product results and conversation</p></figcaption></figure>

### Available Settings

| Setting                               | Description                                         | Default   |
| ------------------------------------- | --------------------------------------------------- | --------- |
| **Heading text**                      | The heading displayed at the top of the chat widget | `AI Mode` |
| **Customer message background color** | Background color of the customer's message bubbles  | `#4E4AFF` |
| **Customer message text color**       | Text color of the customer's messages               | `#FFFFFF` |
| **Widget background color**           | Background color of the chat widget body            | `#F8FAFC` |
| **Send button background color**      | Color of the send button in the widget input        | `#4E4AFF` |
| **Messages text font size**           | Font size for messages in pixels (10–32)            | `16`      |

## Saving Changes

After making changes, click the **Save Changes** button at the bottom of the settings panel. Changes take effect immediately on your website — no code changes required.

## Related

* [Installation](/docs/features/conversational-search/installation.md) — How to add Conversational Search to your website
* [Chat Widget Customization](/docs/features/chat-widget/customization.md) — Customize the main chat widget
* [Styles API](/docs/developer-reference/website-sdk/styles-api.md) — Programmatic style customization


---

# Agent Instructions: 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:

```
GET https://alhena.gitbook.io/docs/features/conversational-search/customization.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.