> For the complete documentation index, see [llms.txt](https://docs.spicychat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spicychat.ai/product-guides/character-chats/chat-appearance.md).

# Chat Appearance

Make your chats look the way you want, with themes, colors, fonts and bubble styles

You can now customize how your chats look. Pick a ready-made theme, give narration, dialogue and bold text their own colors, choose from dozens of fonts, and change how the messages are laid out. Save the looks you like, and share them with other users with a link.

> Chat Appearance is available to everyone. Your look applies to all your chats, not just the one you have open.

#### 🪄 Opening Chat Appearance

1. Open any chat.
2. Select the **⋮** menu in the top-right corner.
3. Select **Chat appearance**.

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2FL6RYD6EEbx4CVX8cvdDG%2Fca-01-open-menu.png?alt=media&amp;token=626e8d73-ff5e-4017-bd55-768518ba520b" alt=""><figcaption></figcaption></figure>

On desktop, the Appearance panel opens on the right side of your chat, with **Colors**, **Text** and **Chat** as tabs. On phones and tablets, it slides up from the bottom, and Colors, Text and Chat open as separate pages.

At the top of the panel you'll find:

* **Styles:** your saved looks, plus sharing and importing (see [Saving and Sharing Styles](https://docs.spicychat.ai/product-guides/character-chats/chat-appearance#saving-and-sharing-styles)).
* **Reset:** undoes the changes you haven't saved yet. A green dot next to it means you have unsaved changes.
* **Done:** saves your changes and closes the panel.

> Nothing changes until you select **Done**. If you close the panel another way (for example with **Esc** on desktop), your changes aren't saved.

#### 👀 Previewing Your Changes

Every change shows up straight away, so you can see the result before you save it.

* **This chat:** preview your look on the chat you have open.
* **Sample chat:** preview it on a sample conversation that uses every kind of formatting: narration, dialogue, bold, highlights, commands and several speakers.
* **🌙 / ☀️:** preview the dark or light version of your look.

#### 🖼️ Themes

A theme is the quickest way to change the whole look. Each one sets the colors for you, and you can adjust them afterwards.

| Theme             | What it's like                 |
| ----------------- | ------------------------------ |
| **Default**       | The standard SpicyChat look    |
| **Night**         | Warm colors with no blue light |
| **Classic**       | The original SpicyChat layout  |
| **High contrast** | Maximum legibility             |
| **Soft**          | Low glare, easy on the eyes    |
| **Sepia**         | Warm and book-like             |

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2FVD2Q1QpiyjJAhqviGGBa%2Fca-02-themes.png?alt=media&amp;token=70514304-a334-4ac4-98c7-5a6fbbde882a" alt=""><figcaption></figcaption></figure>

#### 🌈 Colors

Select **Colors** to choose the color of each part of a message:

| Row             | What it colors                             |
| --------------- | ------------------------------------------ |
| **Narration**   | Actions written in `*asterisks*`           |
| **Dialogue**    | Speech written in `"quotes"`               |
| **Text**        | Plain text                                 |
| **Bold**        | Text written in `**double asterisks**`     |
| **Highlight**   | Text written in `` `backticks` ``          |
| **Commands**    | `/cmd` and `OOC:` instructions             |
| **Bot bubble**  | The background of the character's messages |
| **Your bubble** | The background of your messages            |
| **Background**  | The page behind the chat                   |

For each row, pick one of the suggested swatches. The first swatch, marked **A**, is the theme's default.

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2FE0LgpOAyO4NP6x0mZRaU%2Fca-03-colors.png?alt=media&amp;token=908229eb-6b49-4a25-9f5e-e8d36ac03968" alt=""><figcaption></figcaption></figure>

Once you change a color, the theme card shows **Custom colors** and how many changes you've made. Select **Use a theme** to go back to one of the ready-made themes.

**Picking your own color:** select the last swatch (**+**) to open the color picker. Drag to choose any color, or type a hex code. The number next to it shows how readable the color is against its background (higher is easier to read).

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2FyURPDzjendohrr2rCblh%2Fca-04-custom-color.png?alt=media&amp;token=aa5dd04c-12e4-4c13-9856-53f3f1bb7cee" alt=""><figcaption></figcaption></figure>

**Dark and light colors:** you can set different colors for dark mode and light mode. The panel tells you which one you're editing. Select **Edit Light** (or **Edit Dark**) to switch.

**Readability warnings:** if a color is too hard to read against its background, a warning appears. Select **Fix it** to adjust it automatically.

**Speaker Colors**

Speaker colors are made for bots that play several characters. Any line that starts with a name, like `Keiko: "…"`, gets its own color for the name and its dialogue, so it's easy to tell who's talking. Action text keeps the narration color.

Choose **Bright**, **Soft** or **Earthy**, or **Off** to turn it off. Each speaker in a chat gets a different color, in the order they first appear.

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2F6IOXM4tzS7ULi8aSZPjU%2Fca-05-speaker-colors.png?alt=media&amp;token=38c7be9f-d53e-4f21-846b-b56c849a9511" alt=""><figcaption></figcaption></figure>

#### 🔤 Text

Select **Text** to change the font and how text is sized and spaced.

**Fonts.** Pick one of the quick choices:

* **Default:** the standard SpicyChat font.
* **OpenDyslexic:** heavier letter bottoms help keep letters from flipping or swapping, a common dyslexia aid.
* **Atkinson:** designed for low vision. Every letter shape is distinct, so I, l and 1 never look alike.
* **Lexend:** wide, evenly spaced letters built to reduce reading strain.
* **Serif:** a book-style font for long story sessions.
* **Typewriter:** monospaced, like a script or typewriter.

**Size and spacing:**

* **Text size:** make the chat text bigger or smaller. Turn on **Match device text size** to follow your device or browser text size instead.
* **Line spacing:** add more or less space between lines.
* **Letter spacing:** add more space between letters.

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2Fh45uZm3lQGGaPVAB4D5U%2Fca-06-text.png?alt=media&amp;token=8f9a6881-61c2-452b-89f0-5a6b1758fb2d" alt=""><figcaption></figcaption></figure>

**More fonts.** Select **More fonts** to browse 68 fonts. Search by name, or filter by **Sans**, **Serif**, **Rounded**, **Mono**, **Accessibility**, **Handwriting** and **Retro & fun**. Each font shows a preview line, and your chat updates as soon as you pick one.

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2F9LQVUDSlBwz76SRkNWWV%2Fca-07-more-fonts.png?alt=media&amp;token=124e04a9-b6da-48ad-b70f-6a67fd426295" alt=""><figcaption></figcaption></figure>

> Handwriting and Retro fonts are fun, but they can be harder to read in long replies.

#### 💬 Chat

Select **Chat** to change how messages are laid out.

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2FHtQmk0oE03X0xadcCH1X%2Fca-08-chat-tab.png?alt=media&amp;token=aa62dd91-9b00-49c3-8086-acff90c07802" alt=""><figcaption></figcaption></figure>

**Bubble style:**

| Style       | How it looks                                                                       |
| ----------- | ---------------------------------------------------------------------------------- |
| **Chat**    | Chat bubbles, with your messages on the right                                      |
| **Story**   | Full-width bubbles for everyone                                                    |
| **Book**    | No bubbles. Messages run like the pages of a book, with a line between them        |
| **Script**  | No bubbles. Text is centered, and dialogue is set in small capitals, like a script |
| **Accent**  | No bubbles. A thin colored line runs down the side of each message                 |
| **Classic** | The character's messages sit on the page, and yours are in a full-width bubble     |
| **Minimal** | The character's messages sit on the page, and yours are in a bubble on the right   |

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2FN6AWQfJtJ3Fg6L6SXuh3%2Fca-09-bubble-styles.png?alt=media&amp;token=79e66dd1-29cf-4b3d-9498-82a06e4b1f31" alt=""><figcaption></figcaption></figure>

**More options:**

* **Bubble opacity:** make bubbles see-through. At 0%, text sits directly on the page with no bubbles.
* **Chat width** (desktop): set how wide the chat is, from **Narrow** to **Full width**.
* **Bot avatar** and **Your avatar:** choose the avatar size (S, M, L or XL), or **Off** to hide it.
* **Message header:** where the avatar and name sit on each message.
  * **Mirrored:** the character's on the left and yours on the right (the standard layout).
  * **Left** or **Right:** every message header lines up on the same side.
* **Show commands & OOC:** turn off to hide `/cmd` and `OOC:` lines in the chat. They're hidden from view but still sent to the character.

**While typing:**

* **Live formatting:** colors your narration, bold and dialogue as you type.
* **Auto-close marks:** typing `*`, `"`, `(`, `[` or `{` adds the closing mark for you.
* **Formatting keys:** shows `*`, `"`, `**` and `( )` keys above the keyboard, so you can format without hunting for symbols.

#### 💾 Saving and Sharing Styles

Select **Styles** at the top of the panel to open **My styles**.

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2FgPYvhBM6WjtrSQsKzPIF%2Fca-10-my-styles.png?alt=media&amp;token=c388fcb7-f614-4078-b141-6f80b90d7e8b" alt=""><figcaption></figcaption></figure>

**Saving a Style**

1. Set up the look you want.
2. Select **Styles**.
3. Under **Save Current Settings**, type a name (up to 40 characters) and select **Save**.

Your saved styles are listed underneath. For each one you can:

* **Apply** it to switch to that look.
* **Rename** or **Delete** it.
* Select the **share** icon to share it.

You can save up to **20** styles.

**Sharing a Style**

1. Select **Styles**, then **Share link** (or the share icon next to a saved style).
2. You'll see a preview of the style and what it includes, such as the theme, font and custom colors.
3. Select **Copy link** and send it to anyone.

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2FDGj90YkWAz7GBQRejqCl%2Fca-11-share-card.png?alt=media&amp;token=4c7aa6e8-3b81-49e1-881e-e83fc2d2dd3b" alt=""><figcaption></figcaption></figure>

> Text size and line spacing aren't shared, so everyone keeps the size that's comfortable for them.

**Trying a Shared Style**

When you open a style link, the style is shown on a sample conversation so you can try it before you commit. The banner at the top shows the style's name and who made it.

* **Apply:** switch to this look.
* **Save:** add it to My styles.
* **Discard:** leave without changing anything.

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2F9lFU0KfeRE0gRODxmuii%2Fca-12-trying-shared-style.png?alt=media&amp;token=f59e1fc3-b4e7-4407-b582-40f63ab1d56d" alt=""><figcaption></figcaption></figure>

You can also paste a style link into **Import a shared style** in My styles and select **Load style**.

#### ⭐ Why You'll Love It

✅ **Make it yours.** Match your chats to your mood, your story or your favorite character.

✅ **Easier to read.** Accessibility fonts, high-contrast themes, bigger text and extra spacing help with long sessions and tired eyes.

✅ **Follow the story at a glance.** Different colors for narration, dialogue and each speaker make busy scenes easy to follow.

✅ **Write faster.** Live formatting, auto-closing marks and formatting keys make roleplay formatting quick on any device.

✅ **Share your look.** Save your favorite styles and share them with friends, or try styles other users made.

#### ❓FAQ

<details>

<summary>Does my look apply to all my chats?</summary>

Yes. Your appearance settings apply to all your chats, not only the one you changed them in.

</details>

<details>

<summary>I made changes, but they disappeared. Why?</summary>

Changes are only saved when you select **Done**. If you close the panel another way, your changes are discarded.

</details>

<details>

<summary>How do I go back to the original look?</summary>

Open Chat appearance, select the **Default** theme, and select **Done**. If you changed fonts or chat settings, set them back too. **Reset** only undoes changes you haven't saved yet.

</details>

<details>

<summary>Why does a color in my style look different in light mode?</summary>

Dark mode and light mode have their own colors. In **Colors**, select **Edit Light** or **Edit Dark** to set the colors for each one.

</details>

<details>

<summary>Why aren't all names in a message getting speaker colors?</summary>

Speaker colors only apply to lines that start with a name followed by a colon, like `Keiko: "Hello."`. Make sure Speaker colors is set to **Bright**, **Soft** or **Earthy** in **Colors**.

</details>

<details>

<summary>Will the character see my hidden commands?</summary>

Yes. Turning off **Show commands & OOC** only hides them from view. They're still sent to the character.

</details>

<details>

<summary>Can someone change my style after I share it?</summary>

No. When someone uses your link, they get their own copy of the style. Any changes they make only affect their copy.

</details>

<details>

<summary>How many styles can I save?</summary>

Up to 20. To save another one, delete a style you no longer use.

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.spicychat.ai/product-guides/character-chats/chat-appearance.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
