Skip to content

Update execution model trigger conditions #803

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Nov 3, 2025
Merged

Update execution model trigger conditions #803

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 13 additions & 13 deletions docs/execution-model.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,19 +66,19 @@ The table below lists supported explicit triggers, categorized into those enable
| Triggering event | Explicit Trigger :fontawesome-brands-github: | Default | Conditions |
| --------------------------------------------------------------------- | -------------------------------------------- | ------- | ------------- |
| Checks finished | - | `on` | when an automation uses the `wait_for_all_checks` action |
| Comment added | `comment_added` | `on` | when `pr.comment` in `.cm` |
| :fontawesome-brands-github: Comment edited | - | `on` | when `pr.comment` in `.cm` |
| Commit pushed | `commit` | `on` | |
| Creating a PR | `pr_created` | `on` | when not a draft |
| Description changed | - | `on` | when `pr.description` in `.cm` |
| Label added | `label_added` | `on` | when `pr.label` in `.cm` |
| Label removed | `label_removed` | `on` | when `pr.label` in `.cm` |
| :fontawesome-brands-github: Merging the PR | `merge` | `off` | |
| Title change | - | `on` | when `pr.title` in `.cm` |
| Transition from draft to ready for review | `pr_ready_for_review` | `on` | |
| :fontawesome-brands-github: Transition from any state to closed | `pr_closed` | `off` | |
| :fontawesome-brands-github: Transition from closed to open | `pr_reopened` | `off` | |
| :fontawesome-brands-github: Transition from any state to approved | `pr_approved` | `on` | If there is an automation with one of the actions: `require-reviewers`, `set-required-approvals` or `merge`, or uses `pr.approvals` context variable |
| Comment added | `comment_added` | `on` | when `pr` context is used in `.cm` |
| Comment edited :fontawesome-brands-github: | - | `on` | when `pr` context is used in `.cm` |
| Commit pushed | `commit` | `on` | |
| Creating a PR | `pr_created` | `on` | when not a draft |
| Description changed | - | `on` | when `pr` context is used in `.cm` |
| Label added | `label_added` | `on` | when `pr` context is used in `.cm` |
| Label removed | `label_removed` | `on` | when `pr` context is used in `.cm` |
| Merging the PR :fontawesome-brands-github: | `merge` | `off` | |
| Title changed | - | `on` | when `pr` context is used in `.cm` |
| Transition from draft to ready for review | `pr_ready_for_review` | `on` | |
| Transition from any state to closed :fontawesome-brands-github: | `pr_closed` | `off` | |
| Transition from closed to open :fontawesome-brands-github: | `pr_reopened` | `off` | |
| Transition from any state to approved :fontawesome-brands-github: | `pr_approved` | `on` | when actions `require-reviewers`, `set-required-approvals`, or `merge` are used, or when `pr` context is used in `.cm` |
</div>

Explicit triggers are set independently per each automation block and can be configured at the file level, specific to each automation separately or in combination. If triggers are listed at the file level **and** specific automation, the automation will be triggered according to both triggers.
Expand Down