# 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 %}

![](https://569524371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeX5pvJYI2SPSUPHkxu9p%2Fuploads%2FQ6LQA9p0zeeKBWKXXHrK%2Fimage.png?alt=media\&token=2302cb69-a6f3-4cfc-bcba-44ce72c83993)

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.

![](https://569524371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeX5pvJYI2SPSUPHkxu9p%2Fuploads%2FL4kNV9iEaJ0H8gizOv0x%2Fimage.png?alt=media\&token=b983f7e3-5896-4d94-8725-f18cb02b343e)

{% 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>`.