> From the BotGhost docs: https://botghost.com/docs/custom-commands-and-events/actions/voice-actions/voice-move-a-member
> Every page: https://botghost.com/docs/llms.txt

# Voice Move a Member

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-30_163557825.png)

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.

> **Warning:** Keep in mind the user has to be in a voice channel for this block to work

## User

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

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-17_192258208.png)

**The user who triggered the command**

This selection will move the user who is triggering the command / event or is clicking a [button](https://botghost.com/docs/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-attached-buttons/buttons) / [menu option](https://botghost.com/docs/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-a-select-menu/menu-option).

**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](https://botghost.com/docs/custom-commands-and-events/options/user-option) may be used in this field, IDs and [variables](https://botghost.com/docs/custom-commands-and-events/variables) can be used in [User ID](https://botghost.com/docs/custom-commands-and-events/actions/voice-actions/voice-move-a-member#user-id)

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-17_193623070.png)

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-17_192934324.png)

**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](https://botghost.com/docs/custom-commands-and-events/variables)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](https://botghost.com/docs/custom-commands-and-events/variables)as well.

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-17_193951867.png)

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-17_194149016.png)

## Voice Channel

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

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-17_194445161.png)

**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](https://botghost.com/docs/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-attached-buttons/buttons) / [menu option](https://botghost.com/docs/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-a-select-menu/menu-option).

**Channel Option**

Selecting this channel type will move the user to the voice channel that is selected in the command through the channel option.

### Channel Option

This field requires a [channel option](https://botghost.com/docs/custom-commands-and-events/options/channel-option) in your command. Like other option fields, only the channel option variables can be used in this field. ID's / [variables](https://botghost.com/docs/custom-commands-and-events/variables) can be used in [Channel ID](https://botghost.com/docs/custom-commands-and-events/actions/voice-actions/voice-move-a-member#channel-id)

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-17_200443704.png)

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-17_200256699.png)

**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](https://botghost.com/docs/custom-commands-and-events/variables) 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.

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-18_010655293.png)

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-18_010611857.png)

## 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](https://botghost.com/docs/custom-commands-and-events/variables)can be used as well.

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-18_010819426.png)

## 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](https://botghost.com/docs/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-attached-buttons/buttons) / [menu option](https://botghost.com/docs/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-a-select-menu/menu-option). [Variables](https://botghost.com/docs/custom-commands-and-events/variables)can be used in this field and it must be a plain server ID that is returned.

![](https://botghost.com/docs/content/assets/workspace/image_2024-05-18_011216661.png)

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

![](https://botghost.com/docs/content/assets/workspace/image%20(142).png)

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](https://botghost.com/docs/custom-commands-and-events/variables#error-variables).

![](https://botghost.com/docs/content/assets/workspace/image%20(143).png)
