- 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 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 with our support team