> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/settings/customizing-the-self-service-portal-and-ai-bot-branding.md).

# Customizing the Self-Service Portal and AI Bot Branding

Harmony lets you shape how both the self-service portal and the AI bot appear to your end users. From a single **Branding** section in Settings, you can align the portal's visual style with your organisation's identity and give the AI bot a name and avatar that feel native to your team's Slack or Microsoft Teams environment.

***

### Customising the Self-Service Portal

#### Accessing Portal Branding Settings

1. Open **Settings** from the main navigation.
2. Go to **Portal Preferences** (or the **Branding** section, depending on your view).
3. Look for the portal appearance options described below.

#### Available Options

**Accent Colour**

Set a portal accent colour to match your brand palette. This colour is applied to key interactive elements across the self-service portal, giving users a consistent branded experience.

To set the accent colour:

1. Click the colour picker or enter a hex value in the accent colour field.
2. Select your desired colour.
3. Save your changes - the new colour takes effect immediately for anyone accessing the portal.

**Background Image**

Upload a background image to personalise the visual experience of your self-service portal. This image appears behind the main portal interface, giving you further control over the look and feel.

To upload a background image:

1. Click **Upload** next to the background image option.
2. Select an image file from your device.
3. Save your changes - the image is applied instantly.

{% hint style="info" %}
Branding changes to the portal take effect immediately. No republishing or cache-clearing is required.
{% endhint %}

***

### Customising the AI Bot's Name and Avatar

You can personalise how the Harmony AI bot presents itself to your team in Slack or Microsoft Teams. These settings are managed from the **Branding** section of the Settings page.

#### Accessing Bot Branding Settings

1. Open **Settings** from the main navigation.
2. Select the **Branding** section.
3. Configure the options described below.

#### Available Options

**Custom Bot Name**

Rename the bot from the default "Harmony AI" to any name that fits your organisation or team culture.

To set a custom name:

1. Click the bot name field under **Branding**.
2. Clear the existing name and type your preferred bot name.
3. Save your changes.

**Custom Avatar**

Upload your own logo or image to replace the default bot avatar.

**Requirements for the avatar image:**

* Minimum size: **512 x 512 pixels**
* The image must be **square**

To upload a custom avatar:

1. Click **Upload** next to the avatar field.
2. Select an image file that meets the size and shape requirements.
3. Save your changes.

**Channel or Team Scoping**

Rather than applying customisations globally, you can target specific Slack channels or Microsoft Teams teams. This lets different groups see a differently branded bot if needed.

To apply a scoped customisation:

1. In the **Branding** section, locate the scope selector.
2. Choose the specific Slack channel or MS Teams team you want to target.
3. Configure the bot name and avatar for that scope.
4. Save your changes.

**Multiple Scopes**

You can configure different bot appearances for multiple channels or teams simultaneously.

To add another scope:

1. Click the **Add scope** button.
2. Select the additional channel or team.
3. Set the desired bot name and avatar for that scope.
4. Save your changes.

Each scope is managed independently, so you can maintain distinct branding configurations side by side.

{% hint style="info" %}
If no scope is specified, the bot name and avatar settings apply globally across all connected channels and teams.
{% endhint %}

***

### Summary of Branding Options

| Setting                 | Where to Configure            | Applies To                                |
| ----------------------- | ----------------------------- | ----------------------------------------- |
| Portal accent colour    | Settings - Portal Preferences | Self-service portal                       |
| Portal background image | Settings - Portal Preferences | Self-service portal                       |
| Bot name                | Settings - Branding           | Slack / MS Teams bot                      |
| Bot avatar              | Settings - Branding           | Slack / MS Teams bot                      |
| Channel or team scope   | Settings - Branding           | Specific Slack channels or MS Teams teams |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.harmony.io/settings/customizing-the-self-service-portal-and-ai-bot-branding.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.