Core Docs - Core Concepts - Link to Workflows

Rock Version: v20.0
Last Modified: 2026-10-01 8:17 AM

Most people start workflows from the pages Rock provides, covered in Launch a Workflow. Sometimes you’ll want your own link that opens a workflow directly, such as a button in an email or a row in a report. For example, the Dynamic Data Block runs a database query and shows the results in a grid. Its Selection URL setting turns each row into a link, so staff can start a workflow for any person on the list with one click. The URL parameters in the following sections tell the Workflow Entry block which workflow to open.

Workflow Entry

The Workflow Entry block checks for a WorkflowId or WorkflowGuid parameter in the URL. If found, it will load the existing workflow. If neither is included, a new workflow is created. Either way, the block needs to know the workflow type, either from its block settings or from a WorkflowTypeId in the URL, and an existing workflow only loads if it’s that type. If the workflow isn’t found, the block shows an error instead of starting a new one. The workflow is then processed, and the block will look for the first active form action on the first active activity.

The Workflow Entry page that ships with Rock uses the route WorkflowEntry/{WorkflowTypeId} to start a workflow and WorkflowEntry/{WorkflowTypeId}/{WorkflowId} to open an existing one. In the following examples, 17 is the WorkflowTypeId.

Example links