# GitLab Integration

_By Swathy  · Feb 13, 2025_

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**.
    
    ![](https://vault.featureos.app/uploads/attachment/upload/d56a54c0b1fd4fc7bf4570997555436e.png)
-   Sign into your **GitLab account** and authorize FeatureOS to access your GitLab group.
    
    ![](https://vault.featureos.app/uploads/attachment/upload/7771ad765fb701b6734b680c451f6071.png)
-   Once setup is complete, you'll be redirected to FeatureOS, where you can review integration details, including the connected GitLab group and user profile.
    
    ![](https://vault.featureos.app/uploads/attachment/upload/51fd9743d63c07914aa0acd0fb2784a0.png)

### 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.

![](https://vault.featureos.app/uploads/attachment/upload/cd906237319b642829f6de123bd50085.png)

---

## 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.
    

![](https://vault.featureos.app/uploads/attachment/upload/9938f11dc5e84aed8204ff013e6a5c05.png)

## **Setting Up Sync Rules**

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

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

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

![](https://vault.featureos.app/uploads/attachment/upload/07e98fb5f1651fe2182a0bb754dc5fb1.png)

---

## **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**.
    
    ![](https://vault.featureos.app/uploads/attachment/upload/63281985720d229c9092b99cfdca3c5e.png)

### 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.
    
    ![](https://vault.featureos.app/uploads/attachment/upload/9ce4d8e0a705b9d7b47b33ecf3ec301f.png)

### 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.
    
    ![](https://vault.featureos.app/uploads/attachment/upload/9093223243614ceebb03aaa29520e61e.png)

---

## Disconnect FeatureOS - GitLab Integration

To disconnect:

1.  Go to **Organization Settings** → **Integrations**.
    
2.  Click **Configure** for GitLab.
    
3.  Click **Disconnect** at the bottom right of the modal.
    
    ![](https://vault.featureos.app/uploads/attachment/upload/d8449361c0422f7b91c7e2e1c24f4232.png)

Available on all our pricing plans.

## **Need More Help?**

Contact our support team at [**support@featureos.app**](mailto:support@featureos.app) or submit a request via [our support board](https://feedback.featureos.app/b/feature-requests)! 😃

[View this article on the web](https://help.featureos.app/en/articles/gitlab-integration)