> For the complete documentation index, see [llms.txt](https://documentation.botghost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.botghost.com/custom-commands-and-events/options.md).

# 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. |