Use the branches filter when you want to include branch name patterns or when you want to both include and exclude branch names patterns. When using the pull_request and pull_request_target events, you can configure a workflow to run only for pull requests that target specific branches. For more information about each event and their activity types, see " Events that trigger workflows." on: label: types: When only one activity type triggers a webhook event, the types keyword is unnecessary. The types keyword enables you to narrow down activity that causes the workflow to run. For example, the label is triggered when a label is created, edited, or deleted. Most GitHub events are triggered by more than one type of activity. Use on.types to define the type of activity that will trigger a workflow run. On: label: types: - created push: branches: - main page_build: on.types
If you specify the created activity type for the label event, your workflow will run when a label is created but not when a label is edited or deleted. If your workflow triggers on the label event, it will run whenever a label is created, edited, or deleted. Use on.types to define the type of event activity that will trigger a workflow run.įor example, the issue_comment event has the created, edited, and deleted activity types. Some events have activity types that give you more control over when your workflow should run. If multiple triggering events for your workflow occur at the same time, multiple workflow runs will be triggered. If you specify multiple events, only one of those events needs to occur to trigger your workflow. For example, a workflow with the following on value will run when a push is made to any branch in the repository or when someone forks the repository: on: You can specify a single event or multiple events. Using a single eventįor example, a workflow with the following on value will run when a push is made to any branch in the workflow's repository: on: push Using multiple events These options are described in the following sections. You can also restrict the execution of a workflow to only occur for specific files, tags, or branch changes. You can define single or multiple events that can a trigger workflow, or set a time schedule. For a list of available events, see " Events that trigger workflows." To automatically trigger a workflow, use on to define which events can cause the workflow to run.
If you omit name, GitHub sets it to the workflow file path relative to the root of the repository. GitHub displays the names of your workflows on your repository's actions page. github/workflows directory of your repository. If you're new to YAML and want to learn more, see " Learn YAML in Y minutes." Workflow files use YAML syntax, and must have either a.