# Playlists

Playlists let you organize tracks into named collections. Open the **Playlists** view from the left sidebar to see all your playlists.

## Creating a playlist

Click the **+** button at the top of the Playlists view. Enter a name in the dialog and confirm. You can also save your current queue as a playlist from the queue header menu.

## Adding tracks

Use the three-dot menu (⋮) on any track and select **Add to playlist**, then pick the target playlist. If you have many playlists, a filter input at the top of the submenu lets you narrow them down.

## Editing a playlist

In the playlist detail view, click the **pencil button** in the top-right corner to enter edit mode. You can change the playlist's name and description, then click **Save** to confirm or **Cancel** to discard changes.

## Playlist detail view

Click a playlist card to open it. The detail view shows the tracklist with the same controls as other track tables (+ button, three-dot menu, favorite toggle). From here you can:

* **Play** all tracks or **Add to queue** via the action buttons at the top
* **Reorder** tracks by dragging them
* **Remove** individual tracks with the delete button on each row
* **Export as JSON** from the three-dot action menu
* **Delete** the playlist from the three-dot action menu (asks for confirmation)

<figure><img src="/files/8FRokelAnkCoN5YnnT9G" alt="A playlist detail view showing tracks and action buttons"><figcaption><p>The playlist detail view</p></figcaption></figure>

## Importing playlists

Click the import button (next to the + button) to see two options:

* **Import from JSON**: opens a file picker. Nuclear accepts its own JSON export format as well as some legacy formats.
* **Import from URL**: opens a dialog where you paste a URL. Nuclear checks all installed playlists providers to find one that can handle it. If a match is found, you're taken to a preview page where you can save the playlist locally.

Playlists imported from a URL are **read-only**. You can play their tracks and add them to the queue, but you can't reorder or remove tracks.

## Persistence

Playlists save to disk automatically and persist across restarts.


---

# 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://docs.nuclearplayer.com/nuclear/core-concepts/playlists.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.
