---
title: "Manage Test Trigger Methods - Manual Trigger"
language: "en"
url: "https://docs.testany.io/en/docs/managing-test-manual-trigger/"
markdown_url: "https://docs.testany.io/en/docs/managing-test-manual-trigger.md"
translation: "https://docs.testany.io/zh/docs/managing-test-manual-trigger.md"
last_updated: "2026-03-03T14:24:54+08:00"
---

# Manage Test Trigger Methods - Manual Trigger

## Overview

Manual Trigger lets you run one or more test pipelines on demand, without waiting for a schedule (Plan) or an external webhook (Gatekeeper).

Use it when you need fast, controlled reruns in real operational scenarios, such as:

- validate a hotfix before release
- rerun a known workflow after environment recovery
- execute a standard multi-pipeline verification checklist

## Key Concepts

| Concept | What it means |
| --- | --- |
| Manual Trigger Key | Unique key of a Manual Trigger, format `M-{workspace_key}-{4~5 uppercase hex}` |
| Trigger ID | The trigger object ID. For Manual Trigger, it is `M-{workspace_key}-{4~5 uppercase hex}` |
| Trigger Instance ID | Sequence ID of one run under the same Trigger ID (for example `00007`) |
| Manual Trigger Owner | The user who can edit/delete this Manual Trigger |
| Manual Trigger Executor | The user who actually clicks **Run** for a trigger instance |
| Trigger Instance | One execution event under the same Manual Trigger key (for example `M-WKS-00001-00007`) |

## Before You Start

Make sure you already have:

- a target workspace
- at least one runnable test pipeline
- permission to create/edit Manual Triggers in that workspace

## Create a Manual Trigger

1. Open your workspace, then go to **Trigger** -> **Manual Trigger**.

   ![Manual Trigger list page](https://docs.testany.io/docs/images/en/manual-trigger-list-page.png)

2. Click **Create Manual Trigger**.

   ![Create Manual Trigger dialog](https://docs.testany.io/docs/images/en/manual-trigger-create-dialog.png)

3. Fill in:
   - **Name** (required)
   - **Description** (optional)
   - **Pipelines** (one or multiple)
4. Click **Create**.

## Manage a Manual Trigger

After creation, open the detail page to maintain configuration.

![Manual Trigger detail page](https://docs.testany.io/docs/images/en/manual-trigger-detail-page.png)

You can manage:

- name and description
- bound pipeline set
- owner and labels
- result notification settings


> **Note**
>
> A Manual Trigger can run multiple pipelines in one action. If one pipeline is invalid or has no executable definition, that pipeline run may become `skipped` while other pipelines still execute.


## Run a Manual Trigger

1. Click **Run** on list or detail page.
2. Confirm the pipeline list in the dialog.
3. Click **Confirm Run**.

![Run confirmation dialog](https://docs.testany.io/docs/images/en/manual-trigger-run-confirm.png)

## Check Execution Results

You have two common views:

- **Detail page**: latest 10 trigger instances
- **Execution page**: full history with filters (`triggered_by` and `trigger_source=manual_trigger`)

![Execution history filtered by Manual Trigger](https://docs.testany.io/docs/images/en/manual-trigger-execution-history.png)

You can expand a trigger instance to inspect pipeline-level executions and status breakdown.

## Owner vs Executor

`Manual Trigger Owner` and `Manual Trigger Executor` are different roles:

- **Owner**: resource owner of the Manual Trigger template (maintenance authority).
- **Executor**: operator who starts a specific run.

So one trigger instance can be executed by a different user than the template owner.

## Related Guides

- [Trigger Test Executions](https://docs.testany.io/en/docs/managing-test-executions.md)
- [Manage Test Trigger Methods - Plan Trigger](https://docs.testany.io/en/docs/managing-test-plan.md)
- [Manage Test Trigger Methods - Gatekeeper Trigger](https://docs.testany.io/en/docs/managing-test-gatekeeper.md)
- [Understanding Statuses on Testany Platform](https://docs.testany.io/en/docs/understanding-statuses-on-testany-platform-your-co.md)

## Glossary terms on this page

- [Manual Trigger](https://docs.testany.io/en/docs/glossary.md#manual-trigger)
- [Test Pipeline](https://docs.testany.io/en/docs/glossary.md#test-pipeline)
- [Plan](https://docs.testany.io/en/docs/glossary.md#plan)
- [Gatekeeper](https://docs.testany.io/en/docs/glossary.md#gatekeeper)
- [Manual Trigger Key](https://docs.testany.io/en/docs/glossary.md#manual-trigger-key)
- [Trigger ID](https://docs.testany.io/en/docs/glossary.md#trigger-id)
- [Trigger Instance ID](https://docs.testany.io/en/docs/glossary.md#trigger-instance-id)
- [Manual Trigger Owner](https://docs.testany.io/en/docs/glossary.md#manual-trigger-owner)
- [Manual Trigger Executor](https://docs.testany.io/en/docs/glossary.md#manual-trigger-executor)
- [Trigger Instance](https://docs.testany.io/en/docs/glossary.md#trigger-instance)
- [Workspace](https://docs.testany.io/en/docs/glossary.md#workspace)
- [Execution](https://docs.testany.io/en/docs/glossary.md#execution)
- [Executor](https://docs.testany.io/en/docs/glossary.md#executor)