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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.tability.io/docs/become-a-tability-power-user/integrations/gitlab.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.