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

# GitLab Integration

> Connect Spur with GitLab for automated testing on merge requests.

## Overview

The GitLab integration lets you run Spur tests automatically on every merge request. Test results appear as pipeline status checks directly on the MR, helping your team catch issues before merging.

<Columns cols={2}>
  <Card icon="play" title="Automated Test Execution">
    Test plans run automatically on every merge request without manual intervention.
  </Card>

  <Card icon="circle-check" title="MR Status Checks">
    Pass/fail results appear directly on the merge request in GitLab.
  </Card>
</Columns>

For a full setup walkthrough including `.gitlab-ci.yml` configuration, see the [GitLab CI/CD guide](/running-tests/cicd/gitlab).

## Quick reference

Add the Spur test stage to your `.gitlab-ci.yml` file to trigger test plans on merge request events. Spur provides the configuration you need from the GitLab Integration Settings page.

<Note>
  The full CI/CD setup guide covers everything you need, including configuring test plans and pipeline setup. See the [GitLab CI/CD page](/running-tests/cicd/gitlab) for step-by-step instructions.
</Note>