# YouTube Video Activity

**Insert a YouTube episode as a Pathway Activity.** 

## How to create a YouTube Video Activity

1. **Open a Pathway.**
2. **Select the + icon and then select YouTube Video.** 
3. **Activity name.** Name the activity.
4. **Enter the YouTube Video ID.** To get the video ID, simply copy everything that appears after "[www.youtube.com/watch?v=](http://www.youtube.com/watch?v=)" in the URL. Hit enter to load a video preview.
5. **Add a short snippet.** Write a short description of the video. This will be visible on the Pathway for desktop and tablet only (max. 90 characters).
6. **Write a description.** Write a longer description of the video. This will be visible once a user selects the Pathway tile on mobile, desktop and tablet.
7. **Activity settings.**
   1. **Required.** Set as a required or optional activity. 
   2. **Play Fulfilment.** If set to required, the user must play the video in order to fulfill the activity. 
   3. **Start Playback From.** Enter the time in seconds to start the playback from. 
   4. **End Playback.** Enter the time in seconds after which the playback must end.

{% embed url="<https://cdn.falkor.io/uploads/2020/09/cloud-file-6470/aef1855d3de694838d9b09452b472e92.mp4>" %}
The video ID is everything after "v=" in the link
{% endembed %}

{% embed url="<https://cdn.falkor.io/uploads/2020/09/cloud-file-6470/a41afc63aeb9d5c5fe364e58718363ac.mp4>" %}
Insert the video ID & hit enter
{% endembed %}

## Options

| Options              | Description                                                                                |
| -------------------- | ------------------------------------------------------------------------------------------ |
| **Activity   Name**  | Name the activity/YouTube video (this will appear on the pathway).                         |
| **YouTube Video ID** | Enter only the video ID (the last part of the URL behind the "watch?v=/" part of the URL). |
| **Activity Notes**   | Add text and links.                                                                        |

## Activity Settings

| Setting                 | Description                                                                                                            |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Required**            | Choose whether the activity is required (activity must be fulfilled in order to proceed) or optional (can be skipped). |
| **Play Fulfilment**     | This auto-setting requires users to play the video in order to fulfil the activity (not applicable if optional).       |
| **Start Playback From** | You can set the time at which the video must begin.                                                                    |
| **End Playback At**     | You can set the time at which the video must end.                                                                      |

### YouTube Video Activity: Video not playing / video unavailable in Pathway

{% hint style="info" %}

#### **YouTube videos that don't play may have a restriction or setting applied. If a video is not working, always check the video setting on YouTube.** For consistent usage, ensure that the video in YouTube Studio:

1. is allowed to be embedded;
2. is not restricted to adults.
   {% endhint %}


---

# 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://everyday-digital.gitbook.io/pathways-docs/pathway-editor/pathway-activities/youtube-video-activity.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.