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

# YouTube Integration

> Import videos from YouTube and push captions and metadata back to your channel.

## Overview

Neolli connects directly to your YouTube channel, letting you import videos by URL and push translated captions and localized metadata (titles, descriptions) back without downloading or re-uploading anything.

## Connecting your channel

1. Go to **Workspace Settings → YouTube**
2. Click **Connect Channel**
3. Authorize Neolli via Google OAuth

You can connect one YouTube channel per workspace. The number of channels across all your workspaces depends on your plan:

| Plan    | YouTube channels |
| ------- | ---------------- |
| Starter | 1                |
| Creator | 3                |
| Pro     | 10               |

<Accordion title="OAuth permissions">
  Neolli requests the following Google OAuth scopes:

  * **youtube.readonly** — Read video metadata for import
  * **youtube.force-ssl** — Upload captions and localized metadata via the YouTube API

  Neolli does not modify video content, monetization settings, or channel configuration. You can revoke access at any time from Workspace Settings or your [Google account permissions](https://myaccount.google.com/permissions).
</Accordion>

## Importing a YouTube video

When adding a video, paste a YouTube URL instead of uploading a file. Neolli fetches the video for processing — the original stays on YouTube unchanged.

## Pushing captions to YouTube

Once translation is complete:

1. Open the video workspace
2. Find the completed language track
3. Click **Upload to YouTube**

Neolli creates or updates the caption track on your YouTube video. You can push multiple languages independently.

## What gets pushed

* **Captions** — Translated caption tracks in SRT format, merged with the source transcript for optimal YouTube display
* **Metadata** — Localized video titles and descriptions for each language (improves international discoverability)

<Info>
  YouTube uses localized metadata to show the appropriate title and description to viewers based on their language settings. Pushing translated metadata significantly improves discoverability in international markets.
</Info>

## Upload cooldown

<Warning>
  YouTube enforces API rate limits. Neolli applies a **15-minute cooldown** between uploads for the same video to avoid hitting YouTube's quota. If you see a cooldown message, wait and try again later.
</Warning>

## Disconnecting

To disconnect your YouTube channel, go to **Workspace Settings → YouTube** and click **Disconnect**. This revokes Neolli's access immediately. Previously pushed captions remain on YouTube — they are not removed.