# GitHub

{% embed url="<https://www.youtube.com/watch?v=p49JKbY9NUU>" %}

You can connect GitHub and Jam in order to instantly create GitHub issues right from Jam's browser extension. Every GitHub 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 GitHub Issues fields right from Jam – like repository, assignees, labels and more. Our goal is to make you 20x faster at logging bugs to GitHub Issues.

## How to use Jam + GitHub

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;     [getting-started](https://jam.dev/docs/get-started/getting-started "mention")

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%2F1NhyFtpvKZ3y0jZBO7FD%2Fgithub-1.gif?alt=media&#x26;token=db9ef072-3afc-456e-90ea-5b619c222739" 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 GitHub.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FdRmvTDrq58kuuPVKjhge%2Fgithub-2.gif?alt=media&#x26;token=c259aaca-4958-4e6f-a2db-96b7e0463528" alt="" width="375"><figcaption></figcaption></figure></div>
4. Jam will guide you through authenticating with GitHub.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FBZT5wOknOGUd28oFZh1n%2Fgithub-5.gif?alt=media&#x26;token=e7fc94c0-dc17-46a7-94f5-49ac9c144ada" alt="" width="375"><figcaption></figcaption></figure></div>
5. Once Jam is connected to GitHub, you will be able to setup your GitHub issue right from Jam. Choose the repository, assignees, labels, milestone, 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%2F9nDzlgwIH7PsfnSS9FBO%2Fgithub-4.gif?alt=media&#x26;token=85ee584e-721a-4216-88d1-bb8124d8c8e9" alt="" width="375"><figcaption></figcaption></figure></div>
6. Pro tip: you can click "Edit fields"  to manage which fields from GitHub 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%2FvQies3kbl9JYELpBCdJs%2Fgithub-edit.gif?alt=media&#x26;token=b88746cc-0e18-4078-b1e6-b834d14c02ca" alt="" width="375"><figcaption></figcaption></figure></div>
7. Click "Create issue" and once Jam creates your GitHub 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%2FKLSl1p9q8LAhmZXZdYFL%2Fgithub-6.gif?alt=media&#x26;token=48d33aeb-3088-462f-8cbc-8b0948adc83d" alt="" width="375"><figcaption></figcaption></figure></div>

## How to send existing Jams to GitHub

You can automatically create GitHub 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 GitHub issue.
2. Click "Send to App" and select GitHub.<br>

   <div align="left"><figure><img src="https://1990502200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtAIPUIiSH7MWC0IHLJuD%2Fuploads%2FBydB3kR5YHU9bee8Dn0l%2Fgithub-tools-1.gif?alt=media&#x26;token=e4c53f8b-8454-4d78-97ab-c39786dd9ba7" alt="" width="375"><figcaption></figcaption></figure></div>
3. If you have not used Jam + GitHub before, it will first redirect you to log in with GitHub.
4. Enter the details of your GitHub 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%2FJwOWUY9DzbMVv0DnKMwG%2Fgithub-tools-2.gif?alt=media&#x26;token=f8dbc7c4-bb3c-4fdc-b1b5-0ba7c25c05ee" alt="" width="375"><figcaption></figcaption></figure></div>
5. Pro tip: you can click "Edit fields"  to manage which fields from GitHub are shown in Jam.
6. Click "Create issue" to create your GitHub issue.&#x20;