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

# GitHub integration

> Connect Superthread with GitHub to link pull requests to cards and automate status changes

Superthread allows you to link pull requests to cards and automatically change the status of a card when the pull request changes. This enables your team to:

* See the status of a PR from within a Card.
* Configure Superthread to automatically move a Card to a new status when PRs are created or merged.

## Connect your GitHub account

This only needs to be done once by any member of your team.

Just head to [*Settings > Integrations > Github*](https://app.superthread.com/settings/integration/github)

Currently you can only connect one GitHub account to a workspace.

## Link a pull request to a card

Once connected, you can use the 'Copy git branch name' button in the header of the card. This copies a suggested branch name that includes the card title and card-ID to your clipboard. If you include the card-ID in your branch name, Superthread will automatically create a link between the card and the branch. You can also include the card-ID in the PR title:

* **Branch name** (e.g. "ST-123" or "username/ST-123")
* **Pull request title** (e.g. "GitHub Workflow ST-123")

## Pull request automation

When a card is linked to a pull request, Superthread can automatically move the card to the appropriate status in your Board when the pull request changes.

This is fully configurable on a per Board basis, across all your Boards and Spaces, meaning you have complete flexibility in how you set up the integration.

Simply head to ***Settings > Spaces > Boards*** to configure PR automation for each board.

### Branch-specific automation

You can add automation rules that target specific branches. These will override the default automation rules you have setup. For example, if a PR is merged to *staging*, you can move the card to *In QA* status. However, if a PR is merged to *main*, then move the card to *Deployed* status.

## Viewing PR Status

Once linked, you can see the PR status directly from the card:

* PR status (open, merged, closed)
* Branch name
* Link to the PR on GitHub
* Latest PR activity

## Need help?

If you encounter any issues with the GitHub integration:

* Check that your GitHub account is properly connected
* Verify that the card-ID is correctly included in branch names or PR titles
* Review your automation rules in the board settings
* [Get in touch](./get-in-touch) with our support team