Connect to GitLab

Vinh
Vinh
  • Updated

This feature is available on all plans

You can connect your GitLab account to zeroheight. This will enable you to sync files between GitLab and zeroheight.

Learn more about related features:

When you connect your GitLab account, you can access files from any repository you can access in GitLab — including private and public repositories from the organizations you belong to.

Other users in your team can also use your integration if it is shared. Learn more about sharing git integrations

How to connect to GitLab

GitLab is connected via individual user accounts to the individual's GitLab account.

From Your Profile page

  1. Go to 'Your Profile' and select 'Integrations' from the left-hand navigation panel

    Screenshot 2025-06-09 at 14.53.38.png

  2. Click 'Connect' on the GitLab option

  3. Paste your Personal Access Token from GitLab and optionally uncheck Share this integration with your team if you do not wish to share it
    Personal Access tokens can be created within your GitLab settings. This needs to have the "api" scope enabled in order for you to be able to sync your files with zeroheight

    Screenshot 2025-06-09 at 14.53.38.png

 

How to connect to a self-hosted GitLab instance

Screenshot 2025-06-09 at 14.53.54.png

  1. In the drop down of the "Connect to GitLab" page, select "Self-hosted" from the the "Instance hosting" dropdown
  2. Enter the URL of your self-hosted GitLab instance
  3. Optionally uncheck Share this integration with your team if you do not wish to share it

 

Note: If you need a static IP to allow zeroheight to access your GitLab instance, e.g. through a firewall, please contact support@zeroheight.com

 

FAQs

Who has access to a connected GitLab account?

GitLab accounts are connected at the user level. Only the user who connected their GitLab account can see the repos and the files they contain within zeroheight unless they are shared with the team. Other users within a team will only be able to see files that have been added into zeroheight.

Can I connect public and private repositories?

Yes. When you connect your account, you can access files from any repository you can access in your connected tool— this includes both private and public repositories from the organizations you belong to

What GitLab accounts does zeroheight support?

zeroheight supports Free, Premium, and Ultimate accounts.

What happens if I connect the repo and then I'm no longer part of the zeroheight account?

When you connect GitLab to your account, it's only connected to your personal zeroheight account. If your zeroheight account is deleted, the GitLab connection is made redundant.

What happens to my imported Gitlab content when my Gitlab access token expires?

When your GitLab token expires, your existing content will remain on your styleguides; however, you will no longer be able to sync any new updates from GitLab. To resume syncing you will need to create a new access token and disconnect and reconnect your GitLab integration using this new token in the integration settings in your zeroheight account.

Was this article helpful?