> 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/actions/music-actions/remove-from-queue.md).

# 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 %}