# Voice Move a Member

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

The Voice Move a Member action block will allow the bot to move the specified member, who is already in a voice channel, to a different voice channel.

{% hint style="warning" %}
Keep in mind the user has to be in a voice channel for this block to work
{% endhint %}

## User

This field will allow you to specify which user the bot will be moving.

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

{% tabs %}
{% tab title="The user who triggered the command" %}
This selection will move the user who is triggering the command / event or is clicking a [button](/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-attached-buttons/buttons.md) / [menu option](/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-a-select-menu/menu-option.md).
{% endtab %}

{% tab title="User Option" %}
Selecting "user option" will allow the bot to move a user selected from the option in the command, to a different voice channel.

### User option

You must have a user option added in the command in order for this field to work.\
Only [user options](/custom-commands-and-events/options/user-option.md) may be used in this field, IDs and [variables](/custom-commands-and-events/variables.md) can be used in [#user-id](#user-id "mention")

<figure><img src="/files/0RL0DkI3dlbLQ29xzdY4" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/DlJYKDXfrWuZsxEnYmD6" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="User ID" %}
This selection will allow the bot to move a user who is already in a voice channel, just like the other selections, but it will target a specific user ID or [variable ](/custom-commands-and-events/variables.md)that contains a user ID.

### User ID

This field accepts any plain user ID with no extra symbols or spaces. The ID can be in the form of a [variable ](/custom-commands-and-events/variables.md)as well.

<figure><img src="/files/62fg8Wug8LZxXhfHRTYM" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/25S1kEX81mxcq9hdeIqJ" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## Voice Channel

This field is the specified voice channel that the user will be moving to.

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

{% tabs %}
{% tab title="The voice channel of the user who triggered the command" %}
This channel type will move the user to the same voice channel that they triggered the command / event in or clicked a [button](/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-attached-buttons/buttons.md) / [menu option](/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-a-select-menu/menu-option.md).
{% endtab %}

{% tab title="Channel Option" %}
Selecting this channel type will move the user to the voice channel that is selected in the command through the channel option.&#x20;

### Channel Option

This field requires a [channel option](/custom-commands-and-events/options/channel-option.md) in your command. Like other option fields, only the channel option variables can be used in this field. ID's / [variables](/custom-commands-and-events/variables.md) can be used in [#channel-id](#channel-id "mention")

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

<figure><img src="/files/YK5QTITwZqXJFAhdHsdX" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Channel ID" %}
This selection will move the user into a voice channel specified by a channel ID.

### Voice Channel ID

The channel ID can be a [variable](/custom-commands-and-events/variables.md) as well. Remember this has to be a plain ID with no extra symbols or spaces, it is case sensitive like every other ID field. If you use a variable, make sure it returns a plain ID.

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

<figure><img src="/files/tNSyDyIaTEVfoMla5rtP" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## Optional Reason

This field is an optional reason of why the bot is moving this user to a different voice channel. This reason will appear in your server's Audit Log. [Variables ](/custom-commands-and-events/variables.md)can be used as well.

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

## Optional Server ID

This field is an optional server ID to search for the user in. Leave blank to find the user in the server the command was triggered in or who clicked a [button](/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-attached-buttons/buttons.md) / [menu option](/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-a-select-menu/menu-option.md). [Variables ](/custom-commands-and-events/variables.md)can be used in this field and it must be a plain server ID that is returned.

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

## Enable Success/Error Handles

Enable Success / Error Handles to detect success and errors inside of the action block. This allows you to run different actions if something goes wrong with your action. Inside of the handle, there are 2 different paths which are used to detect the outcome of the action. The green path on the bottom left side of the block indicates success, while the red path on the bottom right side of the block indicates error. You may attach action blocks to each side of the handle to get the outcome of your action block.

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

The Success/Error Handles feature includes 3 different error variables you can use to get information on why the action block encountered an error. Check them out [here](/custom-commands-and-events/variables.md#error-variables).

<figure><img src="/files/jUu4ZOp7dFYZdAS9IVpy" 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://documentation.botghost.com/custom-commands-and-events/actions/voice-actions/voice-move-a-member.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.