Dify - Workflow Test Run

Site: dify|https://dify.ai/

Get plain text:

curl -H "Accept: text/plain" https://jugoya.ai/guides/dify/test-run

Overview

Test a Dify workflow before publishing using the Test Run panel.

Access Test Run

Two methods to open Test Run panel:

Method 1: Click Button

  1. In workflow editor, locate the top toolbar
  2. Find "Test Run" text with keyboard shortcut hint (Option+R)
  3. Click directly on "Test Run" text (not nearby icon buttons)

Method 2: Keyboard Shortcut

  • Press Option + R (Mac) or Alt + R (Windows)

Test Run Panel Structure

Panel appears on the right side with tabs:

TabPurpose
INPUTEnter test input values
RESULTView output after execution
DETAILExecution details
TRACINGStep-by-step trace of workflow

Provide Input Values

Input fields depend on START node configuration.

For Image Input

When workflow requires image (e.g., OCR workflows):

  • text "image" - Field label
  • button "Local upload Choose File" - Upload from computer
  • button "Paste file link" - Use image URL

For Text Input

Input field for each variable defined in START node.

Execute Test

  1. Fill all required input fields
  2. Click button "Start Run"
  3. Wait for execution to complete
  4. Check RESULT tab for output

Common Issues

Clicking Wrong Button

The toolbar area has multiple icon buttons:

  • Environment Variables button (opens env panel)
  • System Variables button (opens sys vars panel)
  • Test Run button (the text "Test Run" itself)

Tip: Click directly on "Test Run" text, not on nearby icon buttons.

Missing Required Input

If START node has required fields (e.g., "image required"), you must provide input before running.

Related Toolbar Elements

Near Test Run button:

  • "Scroll to selected node" - Center view on selected node
  • "Publish" button - Deploy workflow to production
  • Zoom percentage
  • Auto-save status
  • Publication status ("Unpublished" or "Published X days ago")