Creating workflows

Note: GitHub Actions are currently available as a limited public beta, which means you should avoid using it for high-value workflows and content during this beta period. Creating workflows that use GitHub Actions is limited to private repositories during the limited public beta.

Features and requirements may change at any time during this period. You can request to join the limited public beta on the GitHub Actions page. If you're participating in the beta, please contact support if you have any questions.

Workflows are a composite of many different GitHub Actions, or tasks you want to accomplish, and are triggered by webhook events. To create a workflow, you will add one or more workflow blocks to the .github/main.workflow file. Each workflow block will contain any number of Actions you want performed when specified during your workflow.

For more on workflows, see "Creating a workflow with GitHub Actions" and "Viewing your repository's workflow" in the GitHub Help documentation.

Creating a new workflow

Using the visual or file editor, you can create a workflow that contains GitHub Actions, and their relationships to each other. Once you've created a .github/main.workflow file, you need to add workflow and actions blocks.

Workflow configuration options

The workflow configuration options provide the details you need to complete the workflow and actions blocks.

Storing secrets

You can store encrypted secrets in the visual workflow editor or the repository settings and choose which actions within a workflow file will have access to the decrypted values. Production secrets should not be stored in the API during the limited public beta period.

Triggering a repository dispatch webhook

You can use the repository dispatch webhook to trigger workflows from external systems that don't map to one of GitHub's event types.