# Guide: Using Bitbucket with Databox

## How to connect Bitbucket to Databox

![](/assets/guide-using-bitbucket-with-databox_1.e157fd5ab9653f25320bdbcf62fd1059682df85f34f5f09771f45145f2dec997.4783b0ec.gif)

To connect a Bitbucket Account in Databox, go to **Data Sources > + New connection.** Type**Bitbucket** 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 **Bitbucket** login credentials and authorize the Databox app.

## How much historical data is synced when you first connect Bitbucket to Databox?

When you connect a new Bitbucket Data Source in Databox, limited historical data is initially synced.

For more information about the amount of historical data available for a specific Metric, please contact our Support Team at [help@databox.com](mailto:help@databox.com).

Once your Bitbucket Data Source is connected and actively syncing data, we store the data that's collected in our own database. This allows us to accumulate more data over time as more data syncs are made so that you can report on more historical Bitbucket data in your Databox reports. Learn more [here](/data-sync-storage-security-in-databox).

## What time zone does Bitbucket data sync in?

Bitbucket data is synced in UTC.

## Which Bitbucket Repositories are accessible?

It is currently only possible to report on Repositories that you own. It is not currently possible to report on Team Repositories in Databox.

Further, only public Repositories are accessible. Private Repositories are not currently accessible.

## How to access pre-built Bitbucket Templates

![](/assets/guide-using-bitbucket-with-databox_2.66533e1de10af625d8405729e804758b71aef25670627ee884e77b44db28e380.4783b0ec.gif)

1. Navigate to the **Databoards > Public Templates**
2. In the **Data Source** drop-down list, select **Bitbucket**
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 Bitbucket data, click **Use Template**
5. Select the appropriate Bitbucket Data Source from the drop-down list to complete the process. The Databoard will be re-populated with data from the selected Bitbucket 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 Bitbucket Metrics available in Databox [here.](https://app.databox.com/data-manager/metrics/Bitbucket)

## How to build a Databoard using Bitbucket data

![](/assets/guide-using-bitbucket-with-databox_3.870ec91f3bf745f42fac0a7c34e24dd1414ea0a613645d203a3af2329f932b88.4783b0ec.gif)

1. Navigate to  **Databoards** > **+ New Databoard** > **Start Blank**
2. Click on the **Metric Library** icon on the left-hand side of the Designer.
3. Select the appropriate Bitbucket Account from the **Data Source** drop-down list in the **Metric**  **Library.**
4. View the list of pre-built Bitbucket 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 Editor** on the right-hand side of the Designer.
8. Select the appropriate Bitbucket Data Source and Metric in the right-hand Datablock Editor. 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.