> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withrealm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure DevOps

> Connect Azure DevOps to sync work items and repos

Connect Azure DevOps to Realm to make work items, repositories, and documentation searchable. Navigate to **Settings** > **Data sources** and click **Connect** on Azure DevOps, or click **Reconnect** if already connected.

## Connecting Azure DevOps

Click **Connect** on the Azure DevOps data source page. You'll be redirected to Microsoft's OAuth consent screen. Review the permissions and click **Accept**. The person connecting should be an Azure DevOps organization admin.

Once authorized, you'll be redirected back to Realm to select which projects to sync.

## What gets synced

| Content                                               | Synced |
| ----------------------------------------------------- | ------ |
| Work items (tasks, bugs, user stories) and comments   | Yes    |
| Pull requests and PR comments                         | Yes    |
| Repository documentation files (Markdown, HTML, text) | Yes    |

## Selecting projects

After connecting, choose which Azure DevOps projects to sync. You can add or remove projects at any time from the data source page.

## Permissions

Realm enforces Azure DevOps' native permission model. Users can only see content they have access to in Azure DevOps.

You can override this by switching to "Everyone in this organization" on the data source settings page, which makes all synced Azure DevOps data visible to all Realm users.