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

# GitLab

> Review GitLab merge requests directly within Tierity.

## Overview

The GitLab integration brings merge request review into Tierity. View open, merged, and closed MRs, read diffs, and track review status without leaving the platform.

## Prerequisites

* A GitLab account (GitLab.com or self-managed)
* A GitLab personal access token or group access token with `read_api` scope
* Manage access (or higher) in Tierity

## Setup

**1. Create a GitLab access token**

**Personal access token:**

1. In GitLab, go to **User Settings → Access Tokens**.
2. Create a token with the `read_api` scope.
3. Copy the token.

**Group access token (recommended for teams):**

1. Go to your group → **Settings → Access Tokens**.
2. Create a token with `read_api` and the Reporter role.

**2. Configure in Tierity**

1. Go to **Config → Integrations → GitLab**.
2. Enter your **Access Token** and optionally your **GitLab host** (for self-managed instances).
3. Select the **groups or projects** to monitor.
4. Click **Save & Test**.

## What's available

| View | Description |
| - | - |
| **Merge requests** | Open, merged, and closed MRs with author, target branch, and pipeline status |
| **Diffs** | File-level diffs for each MR |
| **Review status** | Approval state and reviewer assignments |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.