# Customizing settings

{% hint style="info" %}
Make sure you selected the right connection before proceeding (`/select`)
{% endhint %}

## Settings command

The `/manage settings` command can be scary at first, but no worries! This guide will show you how to navigate through it.

Before we start, run the `/manage settings` command!

{% hint style="danger" %}
You cannot run commands in a connected channel! Use another channel
{% endhint %}

![](/files/eFjVAu9JYtqperhDBPOq)

I agree it's not very welcoming at first, but you'll get the hang of it quickly

## Setting categories

Every connection setting is organized into 3 separate categories dedicated to different features that Connections Bot offers. They are sorted alphabetically in each section

1. Chat settings allow you to change how your cross-chat works, ranging from changing the appearing username to limiting the number of characters in a message.
2. Logs settings allow you to change what and where changes get logged, the two most important settings here are `Logs` and `MessageLogs`
3. Connection settings are settings that apply to the connection in general like its privacy setting or its rules

## How to change a setting

To change a setting, you need to add the setting name at the end of the command. Like this: `/manage settings <setting>`. The bot will respond with a setting description, status, and modification message.

![](/files/fZhTskwQcZOANCfNldJ3)

{% hint style="info" %}
Setting names are case insensitive, meaning you could run `/manage settings setting:allowbots` or `/manage settings setting:AlLoWbOtS` and it would still work!
{% endhint %}

{% hint style="success" %}
Getting tired of writing the entire setting name? You can use their shortcuts!

Setting shortcuts are just the combination of all their uppercase letters.\
Example: `OriginalToWebhook` becomes `OTW`. `/manage settings setting:OTW`
{% endhint %}

The <mark style="color:red;">Disable</mark> button in this scenario will set the **Current** value to `false`.\
Each setting message can have different buttons depending on their possible or current values.

### How to use different buttons

**The `Reset to default` button** will appear on every setting, this changes the current value to match the default value displayed in the message's embed.

**The `Set to null` button** is usually for text settings (like `rules`) but can also be a way to show the setting is disabled

**The&#x20;**<mark style="color:green;">**`Enable`**</mark>**&#x20;and&#x20;**<mark style="color:red;">**`Disable`**</mark>**&#x20;buttons** will toggle a setting, changing it to `true` and `false` respectively. Just press it and the edit will happen before your eyes.

**The `Text input` button** is for text settings (like `rules`). When you press this button, the bot will ask you to send a text message to the channel. The content of the message you sent will be used as the setting value. Some settings (like `logs`, which checks for a valid channel) have verification methods to make sure what you sent isn't invalid and the bot will alert you/not change the setting if it is.

**The `Choose an option` select menu** will give you a set of options to choose from (usually just one). Press the select menu and choose an option from the drop-down list.

## Popular settings

These are some settings I find most popular amongst ComBot users:

| Name              | Description                                                                                                                                                                        |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Identification    | What is displayed as a username in a message's duplicates                                                                                                                          |
| OriginalToWebhook | Whether to replace the original message with a webhook version to keep consistency across chats                                                                                    |
| ShowOrigin        | <p>If the origin of the message should be displayed in its duplicates:<br><code>from ServerX</code></p>                                                                            |
| TypingMessage     | The style of the `UserX is typing...` message. You can also disable this message                                                                                                   |
| Privacy           | Privacy of the connection, public allows all users to connect a channel, request will leave a request in `/manage requests`, private requires a connection moderator to connect it |
| Logs              | The channel used to log connection changes                                                                                                                                         |

## Congratulations!

You just customized your connection! You can explore the other settings by running `/manage settings <setting>`.


---

# 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://docs.combot.xyz/guides/customizing-settings.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.