# Run a Shipfox Workflow Manually (https://www.shipfox.io/docs/how-to/author-workflows/run-manually)

Description: Add a manual trigger, start the workflow from the Shipfox dashboard, and open the new run.

A manual trigger adds a **Run** action to a workflow. Use it for on-demand work,
testing a new workflow, or repeating a task without waiting for an outside event.

## Add and use a manual trigger [#add-and-use-a-manual-trigger]

### Add the manual trigger

Create `.shipfox/workflows/on-demand.yml`. Replace the command with the task
the project should run. This is a complete workflow:

```yaml
# yaml-language-server: $schema=https://www.shipfox.io/docs/workflow.schema.json
name: On-demand checks
runner: shipfox

triggers:
  manual:
    source: manual

jobs:
  checks:
    steps:
      - key: check
        run: ./scripts/check.sh
```

### Commit and push the file to the default branch

Open the project's **Workflows** tab. Wait for **On-demand checks** to appear
after a successful sync.

### Start the run

Select **Run** next to the workflow. Shipfox queues a new run and confirms
that it started.

### Open the run

Open the project's **Runs** tab. Select the newest **On-demand checks** run
and inspect its jobs and steps.

The event journal for the workspace records the manual call with source `manual` and
event `fire`. Open **Settings → Events** when the action succeeds but no run
appears. A workflow accepts at most one manual trigger.