GitHub security features  ](/en/actions/security-guides/using-githubs-security-features-to-secure-your-use-of-github-actions)
    * [ Automatic token authentication  ](/en/actions/security-guides/automatic-token-authentication)

  * Creating actions 

    * [ About custom actions  ](/en/actions/creating-actions/about-custom-actions)
    * [ Create a Docker container action  ](/en/actions/creating-actions/creating-a-docker-container-action)
    * [ Create a JavaScript action  ](/en/actions/creating-actions/creating-a-javascript-action)
    * [ Create a composite action  ](/en/actions/creating-actions/creating-a-composite-action)
    * [ Metadata syntax  ](/en/actions/creating-actions/metadata-syntax-for-github-actions)
    * [ Dockerfile support  ](/en/actions/creating-actions/dockerfile-support-for-github-actions)
    * [ Set exit codes  ](/en/actions/creating-actions/setting-exit-codes-for-actions)
    * [ Publish in GitHub Marketplace  ](/en/actions/creating-actions/publishing-actions-in-github-marketplace)
    * [ Share from your private repository  ](/en/actions/creating-actions/sharing-actions-and-workflows-from-your-private-repository)
    * [ Share with your organization  ](/en/actions/creating-actions/sharing-actions-and-workflows-with-your-organization)
    * [ Release and maintain actions  ](/en/actions/creating-actions/releasing-and-maintaining-actions)
    * [ CLI setup action  ](/en/actions/creating-actions/developing-a-third-party-cli-action)

  * [ Guides for GitHub Actions  ](/en/actions/guides)

  * [ GitHub Actions ](/en/actions "GitHub Actions") / 
  * [ Using workflows ](/en/actions/using-workflows "Using workflows") / 
  * [ Manually run a workflow ](/en/actions/using-workflows/manually-running-a-workflow "Manually run a workflow")

#  Manually running a workflow

When a workflow is configured to run on the ` workflow_dispatch ` event, you
can run the workflow using the Actions tab on GitHub, GitHub CLI, or the REST
API.

##  Tool navigation

  * [ GitHub CLI  ](?tool=cli)
  * [ Web browser  ](?tool=webui)

##  In this article

  * Configuring a workflow to run manually 
  * Running a workflow 
  * Running a workflow using the REST API 

##  Configuring a workflow to run manually

To run a workflow manually, the workflow must be configured to run on the `
workflow_dispatch ` event.

To trigger the ` workflow_dispatch ` event, your workflow must be in the
default branch. For more information about configuring the ` workflow_dispatch
` event, see " [ Events that trigger workflows ](/en/actions/using-
workflows/events-that-trigger-workflows#workflow_dispatch) ."

Write access to the repository is required to perform these steps.

##  Running a workflow

  1. On GitHub.com, navigate to the main page of the repository. 

  2. Under your repository name, click  **Actions** . 

![Screenshot of the tabs for the "github/docs" repository. The "Actions" tab
is highlighted with an orange
outline.](/assets/cb-15465/images/help/repository/actions-tab-global-nav-
update.png)

  3. In the left sidebar, click the name of the workflow you want to run. 

![Screenshot of the "Actions" page. In the left sidebar, a workflow name is
highlighted with an outline in dark
orange.](/assets/cb-60479/images/help/repository/actions-select-
workflow-2022.png)

  4. Above the list of workflow runs, click the **Run workflow** button. 

**Note:** To see the **Run workflow** button, your workflow file must use the
` workflow_dispatch ` event trigger. Only workflow files that use the `
workflow_dispatch ` event trigger will have the option to run the workflow
manually using the **Run workflow** button. For more information about
configuring the ` workflow_dispatch ` event, see " [ Events that trigger
workflows ](/en/actions/using-workflows/events-that-trigger-
workflows#workflow_dispatch) ."

![Screenshot of a workflow page. Above the list of workflow runs, a button,
labeled "Run workflow", is outlined in dark
orange.](/assets/cb-52943/images