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

# Connect YouTube and Configure Video Privacy and Playlists

> Link your YouTube channel to Hivra to publish Shorts and videos, choose playlists, set privacy levels, and override the video title per post in the Composer.

Hivra connects to YouTube through Google's official authorization flow. Once your channel is linked, you can publish Shorts and longer videos from the Hivra Composer with control over visibility, playlist assignment, and metadata. The video title in YouTube is required and must be set in the YouTube settings modal before you can publish.

## Connect your YouTube channel

<Steps>
  <Step title="Open Integrations">
    In Hivra, go to **Dashboard → Integrations** and find the **YouTube** tile.
  </Step>

  <Step title="Start the redirect">
    Click **Connect** to start the authorization flow.
  </Step>

  <Step title="Authorize with Google">
    You are redirected to Google's authorization page. Accept all requested permissions — these cover uploading videos and managing your channel. Declining any scope prevents the connection from completing.
  </Step>

  <Step title="Verify the connection card">
    After the redirect returns you to Hivra, your channel name and profile picture appear on the integration card. The health chip reads **Healthy** once the monitoring job confirms the token is valid.
  </Step>
</Steps>

<Info>
  Each Hivra workspace connects to a single YouTube channel. If you manage multiple channels, connect each one from a separate workspace.
</Info>

## YouTube publish settings

When you add YouTube as a destination in the Composer, a settings panel appears with the following options.

### Video title

YouTube requires a title for every upload. To set a title for your YouTube video, enter it in the **YouTube title** field in the settings panel. The title you enter here appears in YouTube Studio and on the watch page, while the shared caption remains in the description field on YouTube.

<Tip>
  YouTube titles have a 100-character limit.
</Tip>

### Playlist

Use the **Playlist** dropdown to optionally assign the video to one of your existing YouTube playlists at publish time. The dropdown lists all playlists on the connected channel. If you do not select a playlist, the video is added only to the channel's main uploads.

### Privacy

Set the visibility of the video using the **Privacy** selector:

| Setting      | Who can view                                                                |
| ------------ | --------------------------------------------------------------------------- |
| **Public**   | Anyone on YouTube and in search results                                     |
| **Unlisted** | Anyone with the direct link; does not appear in search or your channel page |
| **Private**  | Only you and people you explicitly invite in YouTube Studio                 |

<Note>
  Scheduled publishing in Hivra uses the privacy setting you choose here. If you want to schedule a YouTube video to go live at a specific time, set privacy to **Public** and use Hivra's scheduled publish time — YouTube will make the video visible at that time.
</Note>

### Per-platform caption override

The YouTube **Description** field is populated from the Composer's shared caption by default. To write a different description specifically for YouTube, click the YouTube tile in the **Customize Caption Per Platform** section and enter your YouTube-specific text. This does not affect the video title.

## Reconnect your YouTube channel

If the YouTube integration card in the dashboard overview shows **Attention/Issue**, your Google token has expired or been revoked.

<Steps>
  <Step title="Open Integrations">
    Go to **Dashboard → Integrations** and locate the YouTube card.
  </Step>

  <Step title="Click Reconnect">
    Click **Reconnect** on the card to restart the Google OAuth flow.
  </Step>

  <Step title="Re-authorize with Google">
    Accept all permissions on Google's authorization page to issue a fresh token.
  </Step>

  <Step title="Confirm the health chip">
    Wait for the monitoring job to run. The chip should return to **Healthy** after the check runs.
  </Step>
</Steps>

<Warning>
  If you revoke Hivra's access from your Google account settings (myaccount.google.com → Security → Third-party apps), the integration card will show **Attention** on the next monitoring cycle. You must reconnect from the **Integrations** page to restore publishing.
</Warning>