> For the complete documentation index, see [llms.txt](https://bigdeckit.gitbook.io/homeworkouthero/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bigdeckit.gitbook.io/homeworkouthero/user-guide/youtube-playlists.md).

# YouTube Playlists

Turn a YouTube playlist into an album in your library.

Follow workouts from YouTube? Import a playlist and its videos become an **album** in your Library. Use them in plans like your own files.

{% embed url="<https://www.youtube.com/watch?v=NX7GZ2Z1fMI>" %}
Importing a YouTube playlist
{% endembed %}

## Importing a playlist

1. Go to **Library** and click **Add from YouTube**.
2. Paste the playlist's link (`https://www.youtube.com/playlist?list=…`).
3. Click **Import**.

The playlist appears as a folder in your Library, named after the playlist. Its videos get:

* **thumbnails and lengths** from YouTube,
* **descriptions**, fetched in the background,
* **tags** worked out from each title. For example, "20 Min Full Body HIIT" is tagged HIIT and Full body. Check them and adjust with **Edit details**.

**The playlist must be Public or Unlisted.** YouTube blocks private playlists, so those can't be imported.

## Things to know

* YouTube videos **play from YouTube**, inside HomeWorkoutHero's player, so they **need an internet connection**. There's no file on your computer.
* You can still **tag**, **favourite** and **plan** with them like any other video.
* **Rename** or **delete** an imported album from its folder page. Deleting asks first and tells you if any plans use its videos; those entries disappear from the plans.
* Imported playlists belong to your [profile](/homeworkouthero/user-guide/profiles.md). Copying your setup to a new profile doesn't copy them.
* **Sharing plans:** a plan made only of YouTube videos can be exported and sent to anyone, and it works for them without the playlist. See [Plans → Importing and exporting](/homeworkouthero/user-guide/plans-and-the-plan-builder.md#importing-and-exporting-plans).
* If you use the [AI Plan Builder](/homeworkouthero/user-guide/ai-plan-builder.md), a YouTube album has a button to tidy up long video descriptions.

{% hint style="info" %}
Respect creators' terms and YouTube's Terms of Service.
{% endhint %}

**Related:** [Video Library](/homeworkouthero/user-guide/video-library.md) · [Plans and the Plan Builder](/homeworkouthero/user-guide/plans-and-the-plan-builder.md)