Skip to main content

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:
PlanYouTube channels
Starter1
Creator3
Pro10
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.

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)
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.

Upload cooldown

YouTube enforces API rate limits. Neolli applies a 6-hour cooldown between uploads for the same video to avoid hitting YouTube’s quota. If you see a cooldown message, wait and try again later.

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.