# Guide: Using YouTube with Databox

## How to connect YouTube to Databox

![](/assets/guide-using-youtube-with-databox_1.2dc54055efcb8a5e63bba98838bee3ddbe36d5e2456f2404e17a2d898988e2ec.4783b0ec.gif)

To connect a YouTube Account in Databox, go to  **Data Manager > + New Data Source.** Type**YouTube** in the search bar and click on the green **Connect**button.

This will open the  **Authorization** window, which is where you will be prompted to enter your login credentials and authorize the Databox app.

Next, select YouTube channel that you'd like to report on in Databox.

## How to connect multiple YouTube channels

If you are managing multiple channels in your YouTube Account, each channel must be added as a separate Data Source in Databox.

## What YouTube permissions do you need to connect to Databox?

You can only connect YouTube channels that you own. Learn more [here](https://developers.google.com/youtube/v3/docs/channels/list)

## What's the maximum amount of historical data initially available when you use a new YouTube Metric in Databox?

Data is synced for the Metrics that are being used in your Account, so when you first use a new YouTube Metric, the maximum amount of historical data available is 36 months.

Certain Metrics may have more or less historical data available. For more information about the amount of historical data available for a specific Metric learn more [here](/guide-using-youtube-with-databox) or contact our Support Team at [help@databox.com](mailto:help@databox.com).

In order to start syncing data for a Metric, you can add it to your Metrics screen, use it in a Scorecard, set a Goal around it, create an Alert for it, or add it to a Databoard. Learn more [here](/data-sync-storage-security-in-databox).
The amount of historical data you're able to access in Databox is dependent on your Databox plan. Learn more [here](/choose-a-subscription-plan).

## What time zone does YouTube data sync in?

YouTube data is synced in UTC.

## How often does YouTube data sync?

All YouTube Data Sources will sync every 12 hours (at 12 am, 12 pm) with Databox.

The reason for this sync schedule is due to technical limitations on the API level.

## How to access pre-built YouTube Templates

![](/assets/guide-using-youtube-with-databox_2.0b305448a444f425e9170d8c5fd988b1fd620e9243aadc093afdca9de45cb10a.4783b0ec.gif)

1. Navigate to **Databoards > Public Templates**
2. In the **Data Source** drop-down list, select **YouTube**
3. To view a preview of the Template populated with dummy data, click **Preview**
4. To pull the Template into your Account and re-populate it with your own YouTube data, click **Use Template**
5. Select the appropriate YouTube Data Source from the drop-down list to complete the process. The Databoard will be re-populated with data from the selected YouTube Account and can be found on the  **Databoards** page


Once the Databoard is available on the **Databoards** page, it is completely disconnected from the public Template. Therefore, you can further customize this Databoard to meet your specific needs using the [Designer](/overview-designer).

View a full list of YouTube Metrics available in Databox [here](https://app.databox.com/data-manager/metrics/YouTube).

## How to build a Databoard

![](/assets/guide-using-youtube-with-databox_3.910faf2c3ceabc6f75cffdd90243a34567f0fb2749abc521754b9ddd4c49c3a2.4783b0ec.gif)

1. Navigate to  **Databoards** > **+ New Databoard** > **Start Blank**
2. Click on the **Metric Library** icon on the lefthand side of the Designer
3. Select the appropriate YouTube Account from the **Data Source** drop-down list in the **Metric Library**
4. View the list of pre-built YouTube Datablocks in the **Metric Library**. Drag and drop your selected Datablock onto your Databoard
5. If a pre-built Datablock isn't available for your use case, click on the  **Visualization Types** icon under the **Metric Library**icon
6. View the list of Visualizations available in Databox. Drag and drop your selected Visualization onto your Databoard
7. Click on the Datablock on the Databoard to open the corresponding **Datablock Settings**on the righthand side of the Designer
8. Select the appropriate YouTube Data Source and Metric in the righthand Datablock Settings. This will update the Datablock and it will populate the Datablock with the corresponding data
9. Complete steps 4-8 until your Databoard is complete


## Metric Considerations

- All Time Date Range is supported only for the metric ''Subscribers''.
- Due to technical limitations, the Date Range ''All Time'' will return a maximum 36 months of historical data.
- Only the top 200 Videos are synced from your YouTube Account. The results are sorted in descending order.


## Granularity Restrictions

- Due to API limitations, hourly granularity is not supported. This may affect visualization options for Charts in Databox. Learn more about Granularity [here](/overview-advanced-settings).


## API Limitations

- YouTube doesn't return data for reports created within the last 48 hours, so the most recent 2-3 days worth of data may not be synced with Databox yet.
- Due to YouTube's API Terms of Service, users are not allowed to create and calculate their own derivated metrics from YouTube's API Data. Therefore, using YouTube Metrics in Data Calculations is not permitted in Databox. Learn more [here](https://developers.google.com/youtube/terms/developer-policies-guide).