# Disconnect from Voice

{% hint style="warning" %}
This action requires a [Premium Subscription](/premium/premium-and-priority-hosting-plans.md#premium-plans) to function.
{% endhint %}

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

The Disconnect from Voice action removes the bot from the current voice channel and can optionally destroy the music player.

## Server

This setting selects which server the action applies to. You have two options to choose from:

{% tabs %}
{% tab title="Current Server" %}

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

When you choose the Current Server option, the bot will disconnect from the voice channel within the server where the command is executed.
{% endtab %}

{% tab title="Server ID" %}

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

When you select the Server ID option, the bot will disconnect from the voice channel of the server matching the provided ID.

### Server ID

In this field, you can enter the ID of the server where you want the bot to disconnect from the voice channel. Variables can be used in this field.
{% endtab %}
{% endtabs %}

## Destroy Player

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

In this option you can choose whether the music player should be fully destroyed and its queue cleared. If set to No, the bot will simply disconnect from voice but keep the existing queue.


---

# 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/music-actions/disconnect-from-voice.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.