# GitHub
The GitHub integration makes it easy to follow GitHub work without leaving Glue. When you share a GitHub link, Glue shows a rich preview with the latest details and keeps the conversation up to date as issues and pull requests change.
### GitHub Link Previews
GitHub link previews in Glue automatically display rich information when you share GitHub links in conversations. These previews show key details about repositories, pull requests, issues, commits, and files without requiring you to leave the conversation. Statuses will update in real time in these previews.
When you paste a GitHub URL into any Glue conversation, the system automatically detects it and generates a rich preview.
### Auto-Subscribe to GitHub Updates
When you share a GitHub issue or pull request link in a thread, Glue automatically subscribes the thread to updates for that issue or PR. Whenever the status changes (e.g., an issue is closed or a PR is merged), a system message is posted to the thread so everyone stays informed.
{% hint style="info" %}
You don't need to add the GitHub app to a thread to auto-subcribe to updates— just share a link with the link preview. If you do not want your thread subscribed to updates, remove the link preview before sending.
{% endhint %}
### Trigger new threads or messages based on GitHub activity
Add the app to a Group or Thread
Add the GitHub app to a group* or thread
The GitHub app can be added to either a group or a thread:
* Group: When adding the GitHub app to a group, it can be configured to either create new threads or send updates to the Group chat.
* Thread: The GitHub app will send notifications to the thread.
To add the GitHub app to a group, navigate to the group and then choose **Apps** from the menu to open the Apps tab of the group settings.
To add the GitHub app to a thread, navigate to the the thread and then choose **Thread Settings** from the menu. With the settings open, choose the **Apps** tab.
From the **Apps** tab of either a group or thread, click to add GitHub.
A modal will appear where you can connect a repository.
Connect a repository
After adding the GitHub app to a group or thread, you will need to choose and configure GitHub repositories that you want to receive updates for.
Start by clicking **Connect a Repo**
When connecting your first repository, you'll be ask to sign in to GitHub. Click **Authorize.**
A window will appear where you can log in to GitHub. Click **Authorize** to let Glue access your account.
After logging in, you'll be asked to install the Glue app for GitHub to you GitHub organization. Click **Install.**
A window will appear where you can choose a GitHub organization. When choosing repositories, make sure to choose all of the repositories you want to use with Glue, not just the ones you want to use with the selected group or thread. You won't receive updates for any repos until you configure them later in Glue and you can configure different repositories for different groups/threads. When you're done, click **Install**.
After signing in and installing the app, choose a Repo from the list and then click **Add**
Choose which events you want to receive messages for and then click **Next**.
If you're connecting a repo to a group, you'll be asked whether you want to send all updates to the group chat or create threads for each Issue, PR, etc.
The repo you added will now appear in the list of repos connected to the group or thread you selected. From here you can connect another repo to this thread or **Remove** any previously connected repos.
To manage this list in the future, go back to the **Apps** section of the group or thread and click the edit button next to GitHub.
Choose which events on Pull Requests or Issues trigger a notification in Glue
Choose which events you want to receive messages for and then click **Next**.
If you're connecting a repo to a group, you'll be asked whether you want to send all updates to the group chat or create threads for each Issue, PR, etc.
The repo you added will now appear in the list of repos connected to the group or thread you selected. From here you can connect another repo to this thread or **Remove** any previously connected repos.
*\*Note that to add an app to a group, you must be a group admin or workspace admin. Anyone can add an app to a thread.*
### Setting up the GitHub Integration
Step 1: Add the GitHub app to your workspace
See instructions for [installing an app in your workspace.](/integrations/integrations-overview/add-integrations-to-your-glue-workspace.md#add-app-to-workspace)
Step 2: Authorize GitHub
Each user will need to authorize access to their GitHub account once. You will be prompted to authorize the first time you paste a Github link into a message.
* Paste a GitHub link into any message in Glue.
* A prompt will appear asking you to authorize Glue to access GitHub. Click **Authorize**.
### GitHub requirements
To use GitHub link previews, your organization needs:
1. **OAuth authentication**: Proper permissions to access GitHub data
2. **Team access**: Appropriate permissions to view the linked GitHub resources
### Troubleshooting
Link previews are not appearing
* Verify GitHub app is installed
* Check repository permissions
* Confirm you have access to the repository
I do not want my thread auto subscribed to app updates
* Just remove the link preview before sending and your thread will not be subscribed to updates.
App updates are not sending for a link I sent
* Make sure you include the rich link preview when you send the link to the thread. If you removed the link preview, the thread will not be subscribed.
* App udpates are only supported in threads, not in other chat types.
How do I unsubscribe my thread from an app update
* This is coming soon.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.glue.ai/integrations/github.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.