# Source: https://jam.dev/docs/integrations/gitlab.md

# GitLab

You can connect GitLab and Jam in order to instantly create GitLab issues right from Jam's browser extension. Every GitLab issue you create with Jam automatically includes:

* Console logs
* Fully inspectable network requests
* URL, timestamp and country
* Device, OS, Browser
* Viewport size
* Network speed

That way, it's perfect for engineers to help them debug issues faster.

You can configure all the relevant GitLab Issues fields right from Jam – like repository, assignees, labels and more. Our goal is to make you 20x faster at logging bugs to GitLab Issues.

## How to use Jam + GitLab

1. First, you'll need to make sure you have Jam installed in your browser. Follow our Jam getting started guide here if you haven't downloaded and setup Jam yet:

&#x20;       [Get Started](https://jam.dev/docs/get-started)

2. Next, capture your bug with Jam.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FR8wiXyYTLuDAfYWwxH9W%2Fgitlab-1.gif?alt=media&#x26;token=40208849-6dee-4010-8c0d-620981665671" alt="" width="375"><figcaption></figcaption></figure></div>
3. In the Jam extension, you will have the option to choose where Jam sends your screen capture to. Click on "Link you can share" and change it to GitLab.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2Fx0ICYUTSzsYWLBnX96DU%2Fgitlab-2.gif?alt=media&#x26;token=0bcf01de-afdf-4378-a3a6-96b6b64103a1" alt="" width="375"><figcaption></figcaption></figure></div>
4. Jam will guide you through authenticating with GitLab.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FQV3PaZVwArQh1caAC1D6%2Fgitlab-3.gif?alt=media&#x26;token=ebd9e295-5d85-4f71-b006-8f26c5a3dd54" alt="" width="375"><figcaption></figcaption></figure></div>
5. Once Jam is connected to GitLab, you will be able to setup your GitLab issue right from Jam. Choose the Project, Assignee, Labels, Due Date, Milestones, etc., right from Jam.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2Fr2neRIiWnSUIFeEC57tG%2Fgitlab-4.gif?alt=media&#x26;token=66d47de5-060d-41ae-9897-d92ec8b63bc5" alt="" width="375"><figcaption></figcaption></figure></div>
6. Pro tip: you can click "Edit fields" to manage which fields from GitLab are shown in Jam:<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2Fj6YQXfFwyBaCvHP4hoH8%2Fgitlab-5.gif?alt=media&#x26;token=e7473171-f972-403e-b33d-d9d28e6fe73d" alt="" width="375"><figcaption></figcaption></figure></div>
7. Click "Create issue" and once Jam creates your GitLab issue, it will automatically open in a new tab.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FzFgUedoI4ubEo59wlujh%2Fgitlab-6.gif?alt=media&#x26;token=791a6295-acd9-4228-9f2a-5a85b5ffbb2e" alt="" width="375"><figcaption></figcaption></figure></div>

## How to send existing Jams to GitLab

You can automatically create GitLab issues from existing Jams – in just 2 clicks.

*Note: You must be logged into Jam to use this feature. Logged out users will not see this option.*

1. Open up the Jam you want to convert to a GitLab issue.
2. Click "Send to App" and select GitLab.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FJs9tgCTCOMKAiXTYOybt%2Fgitlab-7.gif?alt=media&#x26;token=1fead67b-6907-4b82-a05b-9b964848087e" alt="" width="375"><figcaption></figcaption></figure></div>
3. If you have not used Jam + GitLab before, it will first redirect you to log in with Gitlab.
4. Enter the details of your GitLab issue: repository, assignees, labels, milestone, etc. \ <br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2Fl78vBuVxyXXxJkPEkP6G%2Fgitlab-8.gif?alt=media&#x26;token=b9f1bc7a-3834-4f9a-a034-9e3556809b13" alt="" width="375"><figcaption></figcaption></figure></div>
5. Pro tip: you can click "Edit fields"  to manage which fields from GitLab are shown in Jam.
6. Click "Create issue" to create your GitLab issue.&#x20;