# Gitlab Integration

Push FeatureOS feedback to GitLab as issues, link existing issues, and sync statuses with support for both GitLab Cloud and self-hosted instances.

- Category: Version Control
- Provider: FeatureOS
- Website: https://gitlab.com
- Documentation: https://help.featureos.app/en/articles/gitlab-integration
- Story: https://featureos.com/integrations/gitlab

Not every team uses GitHub. If your engineering org runs on GitLab, whether cloud or self-hosted, the GitLab + FeatureOS integration gives you the same feedback-to-issue workflow. Push customer requests directly into GitLab issues, link existing ones, and set up sync rules so both tools stay current.

The setup works with GitLab Cloud out of the box and supports self-hosted instances with a few extra configuration steps.

## How to Connect GitLab Cloud to FeatureOS

1. In FeatureOS, go to **Dashboard > Organization Settings > Integrations > GitLab > Connect**.
2. Sign into GitLab and authorize FeatureOS to access your GitLab group.
3. You land back in FeatureOS with the connected GitLab group and user profile visible.

## Connecting Self-Hosted GitLab to FeatureOS

Running your own GitLab instance? No problem. Enter your **GitLab URL**, **Client ID**, and **Client Secret** in the integration modal, then save to connect.

## Automatically Push Feedback to GitLab Issues

Send FeatureOS posts to GitLab automatically based on status:

- **Push immediately after submission** for real-time tracking.
- **Push after moderation approval** if you review posts before they go public.

## Status Sync Rules Between GitLab and FeatureOS

Configure two-way sync so updates flow between FeatureOS and GitLab:

- When any linked GitLab issue changes status, the FeatureOS post updates.
- When all linked issues change status, the post updates. Useful for multi-issue features.
- When a FeatureOS post changes status, linked GitLab issues update.

Click **Add Rule** to define the behavior, then save.

## Creating and Linking GitLab Issues from FeatureOS

**Create a GitLab issue:** From any FeatureOS post, click **Push to GitLab**, edit the title and description, select Issue Type and Project, then push.

**Link existing issues:** Already tracking that feature? Link multiple GitLab issues to a single FeatureOS post by searching with issue title or ID.

**Unlink:** Remove the GitLab reference from FeatureOS. The issue remains in GitLab.

**Disconnect:** Head to **Organization Settings > Integrations > GitLab > Configure > Disconnect**.

## What GitLab + FeatureOS Does for Your Team

Product managers track progress from FeatureOS. Developers get customer context inside GitLab issues without extra meetings. Status updates keep everyone, including customers, informed as features move through development.

## FAQ

### What is the GitLab + FeatureOS integration?

The GitLab + FeatureOS integration pushes FeatureOS feedback to GitLab as issues, links existing issues, and syncs statuses for both GitLab Cloud and self-hosted instances. Customer requests become development work without losing votes, comments, or status context. It mirrors a feedback-to-issue workflow for teams that standardize on GitLab.

### How do I connect GitLab with FeatureOS?

For GitLab Cloud, go to FeatureOS → Organization Settings → Integrations → GitLab → Connect and authorize access to your group. For self-hosted GitLab, enter your GitLab URL, Client ID, and Client Secret in the integration modal, then save.

### Can FeatureOS automatically create GitLab issues?

Yes. Configure automatic push so FeatureOS posts create GitLab issues immediately after submission or after moderation approval.

### How do statuses sync between GitLab and FeatureOS?

You can update FeatureOS when any linked GitLab issue changes, when all linked issues change, or update linked GitLab issues when the FeatureOS post status changes. Add rules and save them in FeatureOS.

### Does the GitLab integration support self-hosted instances?

Yes. FeatureOS supports GitLab Cloud out of the box and self-hosted GitLab when you provide the instance URL plus OAuth Client ID and Client Secret.

### Can multiple GitLab issues link to one FeatureOS post?

Yes. Search by issue title or ID to link several GitLab issues to a single FeatureOS post, which helps when one request spans multiple projects.

### Which FeatureOS plan includes the GitLab integration?

The GitLab + FeatureOS integration is available on every FeatureOS plan (Starter, Growth, and Business). Your plan sets how many integrations you can enable at once: Starter includes 3, Growth 5, and Business unlimited.

### Who is the GitLab + FeatureOS integration best for?

Engineering orgs on GitLab Cloud or self-hosted GitLab that want FeatureOS customer feedback tied directly to issues and status updates.

---

Source: https://featureos.com/integrations/gitlab
All integrations: https://featureos.com/integrations.md
Product overview: https://featureos.com/featureos.md