Skip to main content
RapidDev - Software Development Agency
n8n-tutorial

How to Run n8n Workflows Manually

Run n8n workflows manually by clicking the Execute Workflow button in the editor or by using the Manual Trigger node. Manual execution lets you test workflows before activating them, inspect each node's output in real time, and debug issues without waiting for a scheduled or webhook trigger to fire.

What you'll learn

  • How to use the Execute Workflow button to test any workflow
  • How to add a Manual Trigger node for on-demand execution
  • How to inspect node output after a manual run
  • How to use test data with manual executions
Book a free consultation
4.9Clutch rating
600+Happy partners
17+Countries served
190+Team members
Beginner7 min read5 minutesn8n 1.0+ (self-hosted, Docker, and n8n Cloud)March 2026RapidDev Engineering Team
TL;DR

Run n8n workflows manually by clicking the Execute Workflow button in the editor or by using the Manual Trigger node. Manual execution lets you test workflows before activating them, inspect each node's output in real time, and debug issues without waiting for a scheduled or webhook trigger to fire.

Why Run Workflows Manually in n8n

Every workflow you build in n8n needs testing before you activate it for production use. Manual execution lets you run the entire workflow on demand, inspect the output of every node, and verify that data flows correctly from start to finish. This is especially important when you are building a new workflow, debugging a failing step, or validating changes after editing node configuration. n8n provides two ways to run workflows manually: the Execute Workflow button and the Manual Trigger node.

Prerequisites

  • A running n8n instance (self-hosted or n8n Cloud)
  • At least one workflow created in the n8n editor
  • Basic familiarity with the n8n visual editor

Step-by-step guide

1

Open your workflow in the editor

Navigate to your n8n instance and open the workflow you want to test. The workflow editor shows all your nodes connected by lines representing data flow. You do not need to activate the workflow to run it manually. In fact, it is best practice to test with manual execution before activating any workflow. Make sure all nodes are fully configured with the required credentials and parameters.

Expected result: Your workflow is open in the n8n visual editor with all nodes visible and configured.

2

Click the Execute Workflow button

Look for the Execute Workflow button at the bottom of the editor canvas. It is a large button with a play icon. Clicking it runs the entire workflow from the first trigger node through every connected node. During execution, each node highlights in sequence, and you can see the status change from waiting to running to success or error. If any node fails, execution stops at that node and shows the error message.

Expected result: The workflow runs from start to finish. Each node shows a green checkmark if successful or a red indicator if it failed.

3

Add a Manual Trigger node for on-demand workflows

If your workflow does not have a trigger node, or if you want a dedicated manual start point, add a Manual Trigger node. Click the plus button on the canvas, search for Manual Trigger, and add it as the first node. Connect it to the rest of your workflow. The Manual Trigger node produces a single empty item when executed, which starts the data flow through subsequent nodes. This is useful when your workflow normally uses a Schedule Trigger or Webhook but you want to test it without waiting.

typescript
1// Manual Trigger node configuration
2// No parameters needed — it fires a single empty item
3// Node type: n8n-nodes-base.manualTrigger
4// Connect its output to the first processing node

Expected result: A Manual Trigger node appears as the first node in your workflow. Clicking Execute Workflow fires it immediately.

4

Inspect node output after execution

After a manual run, click on any node to see its output data. The output panel shows the JSON data that the node produced, along with the number of items. Use the Table and JSON tabs to switch between a formatted table view and raw JSON. This is the primary way to debug data transformation issues. Check that field names, data types, and values match your expectations at each step in the workflow.

Expected result: Each node displays its output data in the side panel. You can see the exact JSON items that flowed to the next node.

5

Use pinned data for repeatable manual tests

When testing a workflow manually, the trigger node may produce different data each time. To get consistent test results, pin data on a node. After a successful execution, click on the node, then click the pin icon in the output panel. Pinned data is saved with the workflow and replayed on every subsequent manual execution instead of fetching live data. This saves API calls and gives you a stable dataset for testing downstream nodes.

typescript
1// Example: pin this sample data on a trigger node
2// Click the pin icon after seeing this output
3[
4 {
5 "json": {
6 "id": 1,
7 "name": "Test User",
8 "email": "test@example.com",
9 "status": "active"
10 }
11 }
12]

Expected result: The node shows a pin icon indicating data is pinned. Subsequent manual executions use this exact data instead of fetching live results.

Complete working example

manual-trigger-workflow.json
1{
2 "name": "Manual Test Workflow",
3 "nodes": [
4 {
5 "parameters": {},
6 "name": "Manual Trigger",
7 "type": "n8n-nodes-base.manualTrigger",
8 "typeVersion": 1,
9 "position": [250, 300]
10 },
11 {
12 "parameters": {
13 "jsCode": "const items = $input.all();\nconst results = items.map(item => {\n return {\n json: {\n message: 'Workflow executed manually',\n timestamp: new Date().toISOString(),\n itemCount: items.length\n }\n };\n});\nreturn results;"
14 },
15 "name": "Process Data",
16 "type": "n8n-nodes-base.code",
17 "typeVersion": 2,
18 "position": [470, 300]
19 },
20 {
21 "parameters": {
22 "conditions": {
23 "string": [
24 {
25 "value1": "={{ $json.message }}",
26 "operation": "isNotEmpty"
27 }
28 ]
29 }
30 },
31 "name": "Validate Output",
32 "type": "n8n-nodes-base.if",
33 "typeVersion": 1,
34 "position": [690, 300]
35 },
36 {
37 "parameters": {
38 "values": {
39 "string": [
40 {
41 "name": "status",
42 "value": "success"
43 },
44 {
45 "name": "detail",
46 "value": "={{ $json.message }} at {{ $json.timestamp }}"
47 }
48 ]
49 }
50 },
51 "name": "Set Success",
52 "type": "n8n-nodes-base.set",
53 "typeVersion": 3,
54 "position": [910, 200]
55 }
56 ],
57 "connections": {
58 "Manual Trigger": {
59 "main": [[{"node": "Process Data", "type": "main", "index": 0}]]
60 },
61 "Process Data": {
62 "main": [[{"node": "Validate Output", "type": "main", "index": 0}]]
63 },
64 "Validate Output": {
65 "main": [
66 [{"node": "Set Success", "type": "main", "index": 0}],
67 []
68 ]
69 }
70 }
71}

Common mistakes when running n8n Workflows Manually

Why it's a problem: Clicking Execute Workflow on an activated workflow and expecting it to run twice

How to avoid: Manual execution and activated triggers are independent. The manual run is a separate execution from any scheduled or webhook-triggered run.

Why it's a problem: Forgetting to configure credentials before running manually

How to avoid: Check that all nodes requiring authentication have valid credentials selected. Unconfigured nodes will fail during execution.

Why it's a problem: Testing with pinned data but forgetting to unpin before activating

How to avoid: Pinned data overrides live input even in production. Unpin nodes before activating the workflow so they fetch real data.

Why it's a problem: Assuming a successful manual run means the workflow is production-ready

How to avoid: Manual runs use test data. Verify that the workflow handles edge cases like empty responses, rate limits, and unexpected field types.

Best practices

  • Always test workflows manually before activating them for production use
  • Use pinned data to create repeatable test scenarios without consuming API calls
  • Check both input and output on each node to verify data transformations are correct
  • Add a Manual Trigger node alongside your production trigger for easy testing
  • Use the Execute Workflow button's keyboard shortcut (Ctrl+Enter) to speed up iterative testing
  • Review the execution history after manual runs to compare results across multiple test executions
  • Delete or disconnect the Manual Trigger node before activating the workflow if it should only run on schedule

Still stuck?

Copy one of these prompts to get a personalized, step-by-step explanation.

ChatGPT Prompt

I have an n8n workflow that I want to test without activating it. How do I run it manually, inspect the output of each node, and use pinned data for repeatable tests?

n8n Prompt

Show me how to add a Manual Trigger node to my n8n workflow so I can test it on demand without waiting for a webhook or schedule trigger.

Frequently asked questions

Can I run a workflow manually without activating it?

Yes. The Execute Workflow button runs the workflow immediately regardless of its activation status. You do not need to activate a workflow to test it manually.

What is the difference between Execute Workflow and activating a workflow?

Execute Workflow runs the workflow once on demand. Activating a workflow enables its trigger nodes to listen for events continuously, such as incoming webhooks or scheduled intervals.

Does manual execution consume the same resources as an activated run?

Yes. Manual executions use the same compute resources and count toward your execution limits on n8n Cloud. They also appear in your execution history.

Can I manually trigger a specific node instead of the entire workflow?

Yes. Click on a node and use the Execute Node button (play icon on the node) to run just that single node. It will use either pinned data or real input from the previous node.

What happens if my workflow has a Webhook trigger and I click Execute Workflow?

n8n will wait for an incoming webhook request. The workflow pauses at the Webhook node until a request arrives. To skip this, add a Manual Trigger node and test with that instead.

Can RapidDev help me build and test complex n8n workflows?

Yes. RapidDev specializes in building production-ready n8n workflows with proper testing and monitoring. Contact RapidDev for a free consultation on your automation project.

RapidDev

Talk to an Expert

Our team has built 600+ apps. Get personalized help with your project.

Book a free consultation

Need help with your project?

Our experts have built 600+ apps and can accelerate your development. Book a free consultation — no strings attached.

Book a free consultation

We put the rapid in RapidDev

Need a dedicated strategic tech and growth partner? Discover what RapidDev can do for your business! Book a call with our team to schedule a free, no-obligation consultation. We'll discuss your project and provide a custom quote at no cost.