How do I connect GitLab to create issues and track merge requests?

Problem This Solves

Link GitLab projects to export action items into issues and follow merge request implementation status.

When to Use This

A GitLab SaaS or self-hosted instance account with project developer or maintainer permissions.

Prerequisites

• A GitLab SaaS or self-hosted instance account with project developer or maintainer permissions.

Step-by-Step Instructions

1. Navigate to Integrations: In /dashboard/integrations, locate and click the GitLab card (subtitled: "Connect projects, create issues from retro cards, and track merge request status").
2. Authenticate with GitLab: Click Connect GitLab to authorize LetRetro via GitLab OAuth, granting permissions to read projects and write issues.
3. Select Workspace Projects: Choose which GitLab groups or individual projects your squads collaborate within.
4. Configure Board Setting: Open your retrospective board and link the primary GitLab project under Settings > Integrations.
5. Create GitLab Issue: On any reflection or action card, click Create GitLab issue, enter title details and labels, and assign a milestone.
6. Track Merge Request Status: When engineers create a merge request closing the issue (Closes #45), merge status updates display right on the retrospective board.

Expected Outcome

Your retrospective action items are immediately connected to GitLab projects and trackable through code review pipelines.

Troubleshooting & Realistic Tips

• Link issues to active sprint milestones in GitLab to ensure retro improvements are scheduled into upcoming sprint iterations.