> For the complete documentation index, see [llms.txt](https://guides.tability.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.tability.io/docs/become-a-tability-power-user/integrations/gitlab.md).

# Gitlab

You can connect Tability to Gitlab to automatically pull metrics from Gitlab for your check-ins without having to switch context.

Once you add Gitlab as a data source for an outcome/Key Result, Tability can:

* Automatically pull the most recent value of the metric when you open the check-in form.
* Perform automatic sync while the plan is active (Premium subscription only).

### How to enable the integration

**Step 1. Upgrade to the Plus or Premium subscription**

You'll need to have a *Plus subscription* to use Gitlab as a data source.

You'll need to have a *Premium subscription* to enable the auto-sync.

**Step 2. Connect Tability to your Gitlab account**

Go to the Integrations admin screen, and look for the Gitlab integration in the "Data connectors" section.

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/60b049fe9c887a0dfc554454/images/64e6e87b6ca77422d09645d5/file-wkZm6xlhCR.png)

Click on "Connect to Gitlab" and complete the steps to connect Tability to your Gitlab account.

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/60b049fe9c887a0dfc554454/images/64e6e98db0995a53905396cc/file-9z3EsN8idS.png)

### How to add a data source to an outcome of Key Result

Once Gitlab is connected, you will be able to use it as a data source for your outcomes/KRs.

**Step 1. Open up your edit panel of your outcome/KR**

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/60b049fe9c887a0dfc554454/images/6466508cc6234261f380e3e6/file-bZLSr0JQOb.png)

Click on "Edit" to open up the Edit panel of any outcome/KR in your workspace.

**Step 2. Select Gitlab as a data source**

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/60b049fe9c887a0dfc554454/images/64e6e9fc6ca77422d09645d8/file-MsthTyAzT9.png)

Go to the "Data source" tab and select Gitlab.

**Step 3. Pick the metric that you would like to connect**

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/60b049fe9c887a0dfc554454/images/64e6ea1e42e1f64bf8026466/file-ecCXOSjX9g.png)

Use the dropdown to select the metric that you want to connect to your outcome/KR.

**Step 4. Select your Gitlab project**

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/60b049fe9c887a0dfc554454/images/64e6ea53b0995a53905396cd/file-EUSF1yvKyX.png)

Use the dropdown to select the organisation and repo that you want to connect to.

**Step 5. Save your connection**

Click on "Save & preview" to complete the connection.

Tability will retrieve the current value for that metric and your screen should look like this 👇

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/60b049fe9c887a0dfc554454/images/64e6ea7242e1f64bf8026467/file-3iUVXbmbre.png)

You can now toggle the option to *Enable auto-sync* of your metric if you're on a Premium subscription.

Tability will retrieve the value of your metric from Gitlab every 48h and will create a check-in on behalf of the owner of the outcome/KR.

The first data sync should happen within 1h of enabling this option.

### How to use the data source in your check-ins

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/60b049fe9c887a0dfc554454/images/64794a97936c7945969ed5a9/file-TCOAIxmKRD.png)

It's all automatic! Once an outcome/KR is connected to a data source, Tability will automatically pull the current value whenever you open up the check-in modal.