GitLab Integration

FeatureOS - GitLab integrations enable easy collaboration between Product Management and Development teams, allowing Product Managers to track feature development directly from the FeatureOS dashboard.

With a simple setup and automatic sync rules, your team can stay updated. Let’s go through the setup process!

Getting Started

1. GitLab Cloud

Navigate to FeatureOS Dashboard → Organization Settings → Integrations.
Scroll down to GitLab → Click Connect.
Sign into your GitLab account and authorize FeatureOS to access your GitLab group.
Once setup is complete, you'll be redirected to FeatureOS, where you can review integration details, including the connected GitLab group and user profile.

2. GitLab Self-Hosted Setup

For GitLab’s self-hosted instance, you can simply enter your GitLab URL, Client ID, and Client Secret to connect.

Configuring Automatic Push to GitLab

Enable Automatic Push to GitLab to sync FeatureOS posts as GitLab issues automatically. You can define trigger rules based on status changes in FeatureOS.

Push posts immediately after submission – Enable this to send posts to GitLab as soon as they are created in FeatureOS.
Post moderation enabled – Enable this to push posts to GitLab once they are approved in moderation.

Setting Up Sync Rules

You can configure two-way status sync between FeatureOS and GitLab. For example,

When any linked GitLab issue changes status, update the linked FeatureOS post and notify/do not notify subscribers.
When all linked GitLab issues change status, update the linked FeatureOS post accordingly.
When a FeatureOS post changes status, update all linked GitLab issues.

Click Add Rule to save, then click Save to apply sync configurations.

How the Integration Works

Once set up, you’ll see a Push to GitLab button within FeatureOS posts. Clicking this gives you two options:

1. Create a GitLab Issue

Only one GitLab issue can be created per FeatureOS post.
Open a post and use the “Push to GitLab” button.
Modify the Title and Description as needed > Select the issue Type & the Project
Click Push to GitLab.

2. Link GitLab Issues

Multiple GitLab issues can be linked to a single FeatureOS post.
Click Push to GitLab / Link to GitLab button > toggle to the Link Issue tab to search by issue title or ID.
Click Link to associate a GitLab issue with the FeatureOS post.
The GitLab issue will then contain a reference to the linked FeatureOS post.

3. Unlink a GitLab Issue

Click the Unlink icon next to the issue.
Once unlinked, the GitLab issue will no longer appear on the FeatureOS post but remain accessible in GitLab.