# Commands

{% hint style="info" %}
When updating or creating a new command, you **must** restart your Discord. You can do so by pressing \
\&#xNAN;**`CTRL + R`** on your keyboard.&#x20;
{% endhint %}

The Command page allows you to view and manage your custom commands for your bot. On this page, you can enable, disable, edit and create new custom commands.

All of your custom commands are listed on this page under the ***Command*** section.

<figure><img src="/files/9H9Mh7GzGVKhvPlKoXgz" alt=""><figcaption></figcaption></figure>

For this page in particular, this section of the guide will outline two categories:

* Creating a new command.
* Creating a folder for your commands.

## Creating a new command

If you have just created your bot, you will have no commands here by default. To create a new command, click the **Create** button. From there, navigate to the **New Commands** button to open a modal to edit your command's features as shown below.

<figure><img src="/files/GcWTCECu0y9o5wwNlxSw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/8rOZllGMiIOCoHAkBZJ3" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/r2oHlU6NeilCvLDABvOU" alt=""><figcaption></figcaption></figure>

This will display a modal prompting you to enter a name, and description for your new command, as well as some check boxes to set it to ephemeral, or nsfw. Below you can find a breakdown of what each option means and how it affects the command.

| Option                | Breakdown                                                                                                                                                                                                                                                                      |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Name                  | The name you enter here, will be the phrase you use to trigger the command in discord using a / notion. For example I have a command named 'tester'. To run this command I would then use <mark style="color:red;">`/tester`</mark> in a discord channel my bot has access to. |
| Description           | Due to discord limitations, a description for all commands is required. The description will be displayed under the / (slash) command popup in discord. It's best to pick a descriptive description so you and your members know exactly what the command does.                |
| Type                  | Choosing the command type determines how the command will be executed. For example, a slash command is triggered by typing a **'/'** followed by the command name in Discord.                                                                                                  |
| Integration Types     | Defines how a command interacts with different systems or platforms within your bot’s setup.                                                                                                                                                                                   |
| NSFW                  | Enabling this will make it so the command can only be seen in the slash commands context menu, and used in NSFW channels. You can read more about this [here](https://support.discord.com/hc/en-us/articles/115000084051-Age-Restricted-Channels-and-Content).                 |
| Sub Command           | A sub command is a specific action nested under a main (parent) command.                                                                                                                                                                                                       |
| Sub Command Group     | A sub command group is a collection of related sub commands grouped under a parent command.                                                                                                                                                                                    |
| Sub Command Parent    | The sub command parent is the main command that holds one or more sub commands or sub command groups.                                                                                                                                                                          |
| Sub Command Parent ID | The sub command parent ID is the internal identifier used to link a sub command or sub command group back to its parent.                                                                                                                                                       |

After creating your first custom command, each custom commands you create will be displayed on the Commands page, along with options on the right side of the command panel. Here you can:

* Enable/Disable the command.
* Edit the command information.
* Go to your builder.

<figure><img src="/files/zS7eQKCXTKSZJsptJtKR" alt=""><figcaption></figcaption></figure>

## Creating a folder for your commands

Organizing your commands in folders can be helpful in many aspects, especially when managing multiple commands. It makes navigation easier within the commands section and helps you quickly locate and manage related commands. Grouping commands by category is simple, and this section will walk you through how to create, edit, and assign commands to folders for better organization.

### Creating your folder

If you have just created your bot, you will have no folders here by default. To create a new folder, click the **Create** button. From there, navigate to the **New Folder** button to open a modal to edit your folder's features as shown below.

<figure><img src="/files/GcWTCECu0y9o5wwNlxSw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/AgulfGEORAyW7yTz2szT" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/VMNEDHYCzxF9lotIqKIa" alt=""><figcaption></figcaption></figure>

This will display a modal prompting you to enter a title for the folder and a color to designate to the folder. Once you have chosen your title and color, a new line will populate just below any commands you have made.&#x20;

<figure><img src="/files/HWrmvG5KTnln0AkLd8ml" alt=""><figcaption></figcaption></figure>

### Editing your folders

To edit your folder's name and color after creating it, simply press on the folder icon. &#x20;

<figure><img src="/files/FZZbbRQjAdlIkkHs0mP1" alt=""><figcaption></figcaption></figure>

After clicking the icon, the **Update Folder** modal will open, allowing you to modify your folder. Once you've made all desired changes, simply click the **Update** button to save and apply them.

<figure><img src="/files/lkG9JmZt9RPl7HyoHAZj" alt=""><figcaption></figcaption></figure>

### Assigning a command to your folder

To assign a command to a folder, press and hold your desired command, then drag it to the folder at which you want it assigned to. Once you have added a command to your folder, the folder icon will show a number indicating how many commands you currently have inside the folder.

<figure><img src="/files/udYclnQrIxCVSBUeTZHn" alt=""><figcaption></figcaption></figure>


---

# 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.botwiz.dev/docs/creations/commands.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.
