Keep Project status in step with pull requests.
Set up an optional, separate connection that updates issue status in matching personal Projects.
Authorize the two connections#
Open Settings → GitHub → Pull Request Automation → Set Up Automation. Install the GitHub App for the repositories you allow, then authorize the separate OAuth App with project offline_access. Desktop authentication and automation authentication are managed separately.
Choose the mapping template#
Choose a personal Project and map its Status field, In Progress, and Done options. All repositories currently allowed for the GitHub App installation are included. The field and option names are applied to every compatible personal Project containing the closing Issue; the template is not the only Project that may change.
Choose Move to In review or Keep in In Progress for Ready PRs. The first policy adds an orange In review option when needed if the matching Project does not already have it.
Link a pull request to an issue#
Add the Issue to a personal Project. For a PR in the same repository, put a closing keyword in the PR description and target the repository’s default branch. For example:
Closes #123Replace 123 with the actual Issue number. Check the relationship in GitHub. Automation changes the Issue’s Project item status, not merely the Issue’s open/closed state.
Understand the state rules#
- Any open closing Draft PR keeps the Issue In Progress.
- No open Draft, but an open closing Ready PR: apply your chosen review policy.
- At least one closing PR, with all closing PRs merged: move to Done.
Processing waits at least three seconds before reading current state; queue and network time add to the delay. Disabling overlapping built-in Project status workflows is recommended to avoid competing updates.
Pause or disconnect#
Pause, resume, reauthorize, or delete the automation connection in Settings. Deletion stops future processing but does not undo prior Project status changes. To revoke GitHub access as well, remove the corresponding OAuth authorization and uninstall the GitHub App.