Status Sync
Automatically update ClickUp task status based on PR lifecycle events.
Overview
Status sync automatically updates your ClickUp task status when PR events occur. This keeps your project board in sync with your code changes without manual updates.
Supported Events
| PR Event | Default Action |
|---|---|
| PR Opened | Move task to "In Review" (configurable) |
| PR Merged | Move task to "Done" (configurable) |
| PR Closed (not merged) | Move task to "Closed" or leave unchanged |
Enabling Status Sync
Configure Status Sync
Enable status sync for each repository in your ClickUp settings.
Open ClickUp Settings- Go to Settings → ClickUp
- Find the repository in Repository Mappings
- Click Configure to expand settings
- Toggle on Sync PR status to ClickUp
- Click Save Mapping
Configuring Status Mapping
You can customize which ClickUp status each PR event maps to:
- In repository mapping, find Status Sync
- Map each PR event to the desired ClickUp status
- Leave blank to skip status updates for that event
Note: The target status must exist in your ClickUp space. If a status doesn't exist, the update will fail silently and be logged.
Example Workflow
- Developer creates branch
feature/CU-abc123-login - Developer opens PR with title
[CU-abc123] Add login page - Task moves to "In Review"
- PR is reviewed and approved
- PR is merged to main
- Task moves to "Done"
Multiple Tasks
If a PR is linked to multiple ClickUp tasks, status updates are applied to all linked tasks. This is useful when a single PR addresses multiple tickets.