> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getunblocked.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab Pipelines

> Connecting GitLab Pipelines to Unblocked

To connect GitLab Pipelines to Unblocked, follow these steps:

<Steps>
  <Step title="Add a CI Provider">
    In the left sidebar, click on **Settings**, then **Continuous Integration**.
    Then click on **Add a CI platform**.
  </Step>

  <Step title="Connect GitLab Pipelines">
    Click on the **GitLab Pipelines** tile. <img src="https://mintcdn.com/unblocked/yVsbHSyeiIZi1Xp1/img/ci/Data-Sources-CI-Integrations.png?fit=max&auto=format&n=yVsbHSyeiIZi1Xp1&q=85&s=e6a299769b0a789f5a462d89d323603a" alt="CI Add" width="2880" height="1820" data-path="img/ci/Data-Sources-CI-Integrations.png" />
  </Step>

  <Step title="Enable CI Failure Agent">
    Click **Select Repositories** to choose the repositories
    you want to enable the CI Failure Agent on. <img src="https://mintcdn.com/unblocked/yVsbHSyeiIZi1Xp1/img/ci/Gitlab-Pipelines-selectRepos.png?fit=max&auto=format&n=yVsbHSyeiIZi1Xp1&q=85&s=101fa5f56719ca363a2c5a47c2b965a6" alt="CI Configure GitLab Pipelines" width="2880" height="1820" data-path="img/ci/Gitlab-Pipelines-selectRepos.png" />
  </Step>

  <Step title="Select Repositories">
    Toggle the repositories you want to enable by selecting them.
  </Step>

  <Step title="Create a Bot Account">
    CI analysis reports need to be posted on behalf of a GitLab user account. We recommend
    creating an Unblocked bot account for this specific purpose.

    <Note>
      <h4>Already have a bot account?</h4>

      <p>
        Some teams already have a bot account they use for posting automated messages. If you already have a bot account that you can repurpose for posting CI
        analysis reports, select it and skip to the next step.
      </p>
    </Note>

    * [Create a new account](https://gitlab.com/users/sign_up) in GitLab.

    * Click on your avatar in the top left, and click **Edit Profile**.

    * Change the following information:
      * **Name:** Unblocked
      * **Avatar:** download and use the Unblocked logo below

            <img src="https://mintcdn.com/unblocked/soZi90zJ9_abJhu-/img/Unblocked-logo-with-bg.png?fit=max&auto=format&n=soZi90zJ9_abJhu-&q=85&s=4254a1a1add3321511dfe55c842cf890" alt="Unblocked logo" width="160" noZoom data-path="img/Unblocked-logo-with-bg.png" />

            <a href="/img/Unblocked-logo-with-bg.png" download="Unblocked-logo.png">
              Download PNG
            </a>

    * **Sign out** of your GitLab bot account.

    * **Sign in** as a Group admin for your GitLab Group and navigate to it.

    * Click **Manage** in the left navigation and select **Members**.

    * Click **Invite members**

    * Set the role as "**Planner**" or above and click "**Invite**".
  </Step>

  <Step title="Select your Bot Account">
    Search for the Bot Account you just created and select it. You may be required
    to authorize this account with Unblocked.

    <Warning>
      In order to successfully authorize your bot account, you need to be logged in with that account in GitLab.
    </Warning>

    <img src="https://mintcdn.com/unblocked/yVsbHSyeiIZi1Xp1/img/ci/Gitlab-Pipelines-selectBotAccount.png?fit=max&auto=format&n=yVsbHSyeiIZi1Xp1&q=85&s=2f01ce753c3ce965ee6e584f1a0094e2" alt="CI Configure GitLab Pipelines" width="2880" height="1820" data-path="img/ci/Gitlab-Pipelines-selectBotAccount.png" />
  </Step>

  <Step title="Done">
    Click **Save Settings** to apply your changes. Now Unblocked will analyze CI
    failures in the selected repositories and post reports to pull requests.
  </Step>
</Steps>