> 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/features/outcomes-key-results/data-sources.md).

# Data sources

Pull progress data from the tools your team already uses

## Overview

Connect a data source to a key result (KR) when its current value already lives in another tool. Tability can retrieve that value while you are checking in, so you do not have to switch between applications or copy the number manually.

{% hint style="warning" %}
Data sources are available on **Plus** and **Premium** subscriptions, and during a trial. [Auto-sync](/docs/become-a-tability-power-user/integrations/auto-sync-for-data-sources.md) requires **Premium** or a trial.
{% endhint %}

You need permission to edit the KR. Workspace administrators can also restrict which connectors members are allowed to configure.

## Connect a data source

1. Open the KR.
2. In the **Data connector** section, click **Add data source**. You can also edit the KR and open the **Data source** tab.
3. Select a data source.
4. If prompted, connect the relevant workspace or personal account.
5. Configure the metric or query, then save it.

<figure><img src="https://318707989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMULqjSmZyGczPy2I6FGH%2Fuploads%2FlkQIo7Og2388usZD0bMb%2FGroup%2064(1)(1).png?alt=media&amp;token=c37f9c6d-b9ad-4089-a4dc-e5ef9173d7c4" alt="Data source settings for a key result"><figcaption></figcaption></figure>

The list you see depends on your workspace configuration and permissions. Tability supports connected services such as Google Sheets, Jira, HubSpot, Salesforce, Sentry, Power BI, Tableau and SQL databases, as well as work-management tools and other supported integrations.

If a connector is marked **not connected**, follow the prompt to connect the required account first. If its detailed configuration is hidden, ask a workspace owner, admin or IT admin to allow the connector or make the change for you.

## Use the connected value

### During a check-in

<figure><img src="https://318707989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMULqjSmZyGczPy2I6FGH%2Fuploads%2FhLmrM5WNqsiha64CeSgx%2FGroup%2069(1).png?alt=media&amp;token=4e5fde08-e3d3-4f5d-ad27-386c6555bb86" alt="A connected data source supplying the current value during a check-in"><figcaption></figcaption></figure>

When you create a check-in, Tability retrieves the current value from the connected source. Review the value, then add the context and confidence that the number alone cannot provide.

### Sync the value immediately

Open the KR and click the connected source in the **Data connector** section to retrieve the latest value without waiting for the next scheduled sync. Tability also shows when the source was last synced.

### Sync on a schedule

Premium workspaces can create automated progress updates on a daily or weekly schedule. See [Auto-sync for data sources](/docs/become-a-tability-power-user/integrations/auto-sync-for-data-sources.md).

## Link to supporting data

Choose **Link** when you only need to make a dashboard, report or source page easy to reach. Tability displays the URL during check-ins but does not retrieve a numeric value from it. Links do not support auto-sync.

## Rollups and initiative-based KRs

Do not use a data-source connector to calculate progress from dependent KRs or completed initiatives. These legacy connectors are read-only.

Instead, edit the KR and choose the appropriate **KR type**:

* **Roll up from dependent KRs** to calculate progress from connected KRs.
* **Initiatives or milestones completed** to calculate progress from attached work.

Data sources are not available for rollup or milestone KR types because their progress is calculated inside Tability.

## Change or remove a data source

1. Open the KR.
2. In the **Data connector** section, click the settings icon.
3. Use the **Data source** tab to change the configuration, enable auto-sync, or remove the current source.

Removing a data source stops future retrievals. Existing check-ins remain in the KR history.
