# Organizing a playlist

Playlists are the smallest unit that can be played in a Player. The playlist can be composed of one or several Medias as well as Widgets (TODO: ADD LINK), and as such we can mix images, videos and widgets in the same playlist.

Playlists also allows you to define a layout, such as landscape, portrait, and with different sections. You can put any content you want in every section. But for this guide we will just pick the simplest layout which is the Landscape:

![Dialog to select layout and create a new playlist.](https://1755730677-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYzHH-6laXHQorG99mv%2F-M_LJ3hjbpgqCKkIEtOw%2F-M_LK2zFg7DaSqWV63xX%2Fimage.png?alt=media\&token=6cc16867-36c7-4827-81b5-137e7985113b)

By clicking in "New Playlist" we will create our first playlist. And we can now "drag and drop" from the medias that we uploaded before:

![](https://1755730677-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYzHH-6laXHQorG99mv%2F-M_LJ3hjbpgqCKkIEtOw%2F-M_LKVAXy8TdPfIEYM_Q%2Fimage.png?alt=media\&token=e290341a-825a-4287-85e9-72b0ced7d662)

We can just pick the previous image:

![](https://1755730677-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYzHH-6laXHQorG99mv%2F-M_LJ3hjbpgqCKkIEtOw%2F-M_LKc0q54uQ9j79T3GW%2Fimage.png?alt=media\&token=3d71b526-d977-4540-a85c-fb41cb86c0a1)

Now the playlist is composed of one the image we uploaded before. By default the images will be displayed during 30 seconds, and thus this playlist will be 30 seconds long since there is only one image:

![](https://1755730677-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MYzHH-6laXHQorG99mv%2F-M_LJ3hjbpgqCKkIEtOw%2F-M_LKwbR8V_6INsGQd6l%2Fimage.png?alt=media\&token=05ff30a4-2549-42eb-b741-f21d0c38308d)

Now we have everything we need in order to show content on our player, we just need to use the Calendar!.


---

# 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.castmill.com/getting-started/organizing-a-playlist.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.