> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beatpass.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# Queue & Playback

> Manage the current listening queue, understand shuffle and repeat, and know how queue playback differs from playlists.

The queue is the temporary list BeatPass is using for the current listening session. It is separate from playlists and is built from whatever you last played or explicitly added to the queue.

## How The Queue Gets Built

* Playing a track, playlist, collection, radio page, or channel can seed a queue.
* Context menus can add more items with **Add to queue**.
* Playback controls then move through that queue using previous, next, shuffle, and repeat.

## Where To Open The Queue

| Device  | Queue surface                                                              |
| ------- | -------------------------------------------------------------------------- |
| Desktop | Right-side panel labeled **Queue**                                         |
| Mobile  | The expanded player overlay, with **Now playing** and **Up next** sections |

## What You Can Do In The Queue

<CardGroup cols={2}>
  <Card title="Review the session order" icon="list-music">
    See the current item and the upcoming tracks without leaving the player.
  </Card>

  <Card title="Jump to another item" icon="forward">
    Click or tap a queued item to start it immediately.
  </Card>

  <Card title="Shuffle playback" icon="shuffle">
    Randomize the listening order for the active queue.
  </Card>

  <Card title="Use repeat" icon="repeat">
    Keep the queue cycling according to the current repeat mode.
  </Card>
</CardGroup>

## Desktop Details

On desktop, the queue panel:

* Opens from the queue button in the player bar.
* Shows the queue title and current track count.
* Keeps a dedicated **Now playing** area at the top.
* Includes a shuffle toggle inside the panel.

## Mobile Details

On mobile, the queue lives inside the expanded player overlay:

* The overlay separates the current item from the upcoming list.
* The queue section is labeled with **Now playing** and **Up next**.
* The current implementation shows a shortened upcoming list in the mobile queue view instead of the entire queue at once.

## Queue vs. Playlists

| Queue                            | Playlist                                   |
| -------------------------------- | ------------------------------------------ |
| Built for the current session    | Saved to your account                      |
| Changes as you play or add items | Remains until you edit or delete it        |
| Not a sharing feature            | Can be public, private, or collaborative   |
| Opened from the player           | Opened from playlist pages and the library |

<Warning>
  Do not treat the queue as a permanent list. If you want to keep a set of tracks, move that idea into a playlist.
</Warning>