# Remove from Queue

{% 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/aBcO9gm2U4fhx0mOb0aD" alt=""><figcaption></figcaption></figure>

The Remove from Queue action removes track(s) from the music queue.

## 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 Remove From Queue action will be applied to 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 action will be applied to the server matching the provided ID.

### Server ID

In this field, you can enter the ID of the server where you want the track to be removed from the queue. Variables can be used in this field.
{% endtab %}
{% endtabs %}

## Remove Mode

This setting lets you choose how tracks should be removed from the music queue. You have three options to select from:

{% tabs %}
{% tab title="Remove Track at Position" %}

<figure><img src="/files/2H1sP2TJgIJV4edlCu56" alt=""><figcaption></figcaption></figure>

Removes a single track from the queue based on its position.

### Queue Position

Use the Queue Position field to specify which track should be removed. Position values start at 0, where 0 is the first track and 1 is the second track.
{% endtab %}

{% tab title="Remove Range of Tracks" %}

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

Removes multiple tracks at once by specifying a start and end position.

### Start Position

The position of the first track to remove, included.

### End Position

The position of the last track to remove, included.
{% endtab %}

{% tab title="Clear Entire Queue" %}

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

Removes all tracks from the queue.
{% endtab %}
{% endtabs %}


---

# 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/remove-from-queue.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.