GitLab Integration – QA Proof Help Center Skip to main content

GitLab Integration

Connect QA Proof with GitLab to create issues for visual bugs and integrate design QA checks into your merge request workflow.

Connecting GitLab

  1. Go to Settings → Integrations
  2. Click "Connect GitLab"
  3. Enter your GitLab instance URL (for self-hosted) or use gitlab.com
  4. Authorize QA Proof with your GitLab account
  5. Select the projects to connect

Merge Request Integration

QA Proof can run visual tests on every merge request:

  • Results appear as pipeline status on the MR
  • Visual diff screenshots are posted as MR comments
  • Optionally block merging if visual tests fail

Automatic Issue Creation

Configure QA Proof to create GitLab issues when visual bugs are found:

  • Issues include before/after screenshots
  • Labels and severity are set automatically
  • Assign to team members based on project area

Webhook Configuration

For advanced setups, configure webhooks to trigger QA Proof tests from GitLab CI pipelines. See the API documentation for webhook endpoint details.

Self-Hosted GitLab

QA Proof supports both gitlab.com and self-hosted GitLab instances. For self-hosted, ensure your instance is accessible from QA Proof's servers and provide the custom URL during setup.