A workflow can run on repository activity, on a schedule, or when someone starts it manually or from outside GitHub. You list the triggers under the on key:
- Repository events:
push,pull_request, andreleasewhen a release is created or published.createanddeletefire when a branch or tag is created or deleted. - Scheduled events:
scheduleruns on a cron expression, at most once every 5 minutes. - Manual and external events:
workflow_dispatchis a manual trigger with optional inputs.repository_dispatchlets an outside system trigger a run through the API. - Other GitHub activity:
check_runfor check run activity, anddeploymentwhen someone creates a deployment.
By default, pull_request only runs when a pull request is opened, synchronized or reopened. There is no generic webhook event.
on:
push:
branches: [main, develop]
pull_request:
branches: [main]
schedule:
- cron: '0 2 * * *' # Daily at 2 AM
workflow_dispatch:
Rewriting in plainer words…
This answer doesn't lend itself to a diagram - it reads best . No credits were charged.
Why there's no diagram: “”
The interactive diagram is below the answer - jump to diagram ↓ · Below it, the related concept . Jump to it ↓
The diagram below the answer is the concept . Jump to it ↓
Tailored explanation · switch back to · ·
What should the new diagram focus on?