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

# YouTube

> Add YouTube URLs to Cloudglue for analysis

Add public YouTube video URLs to a Cloudglue [collection](/core-concepts/entity-collection).

<Warning>
  YouTube URLs are processed as **audio only**. For full video analysis
  including visual descriptions, add the original video file via [Local
  Files](/data-connectors/local-files) or a [data
  connector](/data-connectors/overview#data-connectors) instead.
</Warning>

## Add on the dashboard

From the **Data Connectors** page, click **YouTube** under Other Sources. Paste one or more YouTube URLs, pick a collection, and add them.

<Frame>
  <img src="https://mintcdn.com/aviary/vr_AhY8NsU7HK1Pd/images/youtube-modal.png?fit=max&auto=format&n=vr_AhY8NsU7HK1Pd&q=85&s=62ba30f33f572d3a631fc669df5e3bfd" alt="Add YouTube videos modal" width="2822" height="2122" data-path="images/youtube-modal.png" />
</Frame>

## Add with the API/SDK

```javascript theme={null}
const result = await client.collections.addVideoByUrl({
  collectionId: 'my-collection-id',
  url: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
  params: {},
});
```

See [Add Media to Collection](/api-reference/endpoint/collections/media-post) for the full API reference.

<Note>
  YouTube URLs can only be added to a collection. [Sync File from
  URL](/api-reference/endpoint/files/sync) does not accept YouTube URLs.
</Note>