# Options

Options are purple in color and are used for users to input values into the command, which can then be referenced anywhere within the command with the variable {option\_optionname}. Options function when a command is about to be executed, which creates fields to be able to input values into.\
\
Additionally, options are automatically connected to the command when added. They are also only available in commands and aren't required to be in the command.

## Option Blocks

| Block                                                                                         | Information                                                                                          |
| --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| [Text Option](/custom-commands-and-events/options/text-option.md)                             | The text option block allows for a text value to be input.                                           |
| [Number Option](/custom-commands-and-events/options/number-option.md)                         | This block allows a number value to be input.                                                        |
| [User Option](/custom-commands-and-events/options/user-option.md)                             | This option allows you to select a user from a list of server members.                               |
| [Channel Option](/custom-commands-and-events/options/channel-option.md)                       | This option allows you to select a channel from a list of server channels.                           |
| [Role Option](/custom-commands-and-events/options/role-option.md)                             | This option allows you to select a role from your server.                                            |
| [Choice Option](/custom-commands-and-events/options/choice-option.md)                         | With this option you are able to select true or false from a dropdown.                               |
| [Attachment Option](/custom-commands-and-events/options/attachment-option.md)                 | The attachment option allows you to upload an attachment to the command.                             |
| [Music Smart Search Option](/custom-commands-and-events/options/music-smart-search-option.md) | The music smart search option can be used to let users search for music tracks when using a command. |


---

# 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://documentation.botghost.com/custom-commands-and-events/options.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.