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

# Chat Settings

Chat settings are useful to let each user configure their chat experience given a set of options.

## How it works

Check the chat settings [API reference](/api-reference/chat-settings) to learn how to configure it.

## Preview

If chat settings are set, a new button will appear in the chat bar.

<img src="https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/open-chat-settings.png?fit=max&auto=format&n=b2WeFP1vh0enOZXn&q=85&s=a9ea9b17e4ba16995f24dfc7e67a75bb" alt="OpenChatSettings" width="2022" height="284" data-path="images/open-chat-settings.png" />

Clicking on this button will open the settings panel. All settings are editable by the user. Once settings are updated, an event is sent to the Chainlit server so the application can react to the update.

<Frame caption="Chat Settings in Chainlit">
  <img src="https://mintcdn.com/chainlit-43/b2WeFP1vh0enOZXn/images/chat-settings.png?fit=max&auto=format&n=b2WeFP1vh0enOZXn&q=85&s=0f43b1020f994bda54a146b5304fbb77" width="952" height="1354" data-path="images/chat-settings.png" />
</Frame>

## Example

Check out this example from the cookbook that uses this feature: [https://github.com/Chainlit/cookbook/tree/main/image-gen](https://github.com/Chainlit/cookbook/tree/main/image-gen)