One-Shot workflows: run a workflow manually

In this article:

• What a One-Shot workflow is
• Create a One-Shot workflow
• Fetch resources: process many items at once
• Get resources: run for one item you choose
• Run the workflow
• Check the result

Most workflows wait for a store event, such as a new order. A One-Shot workflow doesn't wait for anything: you start it yourself, whenever you need it. Use it for one-time jobs on existing store content, such as tagging old products, fixing data on past orders or sending something to a selected list of customers.

What a One-Shot workflow is

• It has no trigger event. Instead, it starts with Get content, where you choose which store items to work with.
• It doesn't need to be turned on. It runs only when you click Run flow.
• You can run it again any time later.

You'll find your One-Shot workflows in the workflow list under the One-shot tab.

Create a One-Shot workflow

1. On the React Flow home page, click Create new > Create from scratch.
2. On the One-Shot card ("Perform one-time actions for your existing store content"), click Create.

3. Under Select resource, choose how to get the content:
4. • Fetch resources: Collections, Customers, Draft orders, Metaobjects, Orders or Products. The workflow runs once for every item that matches your filter.
   • Get resources: Get collection, Get customer, Get draft order, Get order or Get product. The workflow runs for one item you pick when you start it.

4. Add conditions and actions, the same way as in any workflow.
5. Click Save and enter a name.

Fetch resources: process many items at once

When you choose a Fetch resource, for example Products, set which items the workflow should process:

• Sort data by: the field and order to process items in.
• Maximum number of products: the most items to process. Leave it empty to process all matching items.
• Select a query option to filter data: a ready-made filter, such as Products by tag or Out of stock somewhere, or Advanced to write your own. Click Test to see the list of matching items.

The Runs counter at the top shows how many items the current settings will fetch. Each item counts as a separate workflow run.

Add the actions under for each. They run once for every fetched item.

For all settings and query examples, see the article about the Fetch action.

Get resources: run for one item you choose

When you choose a Get resource, for example Get product, you don't pick the item in advance. React Flow asks for it each time you run the workflow. This is useful for jobs you repeat for different items, for example "create a PDF spec sheet for this product".

Run the workflow

1. Open the saved workflow and click Run flow in the top right corner.

2. Confirm the run:
3. • For Fetch resources, the Runs limit window shows how many runs the workflow will start. Click Run flow to continue.

• For Get resources, choose the item in the list (for example Choose a product to run the workflow) and click Run flow.

To check the logic without changing anything, use Run Test first (available for Get resources), and choose Simulate.

Check the result

After you start a Fetch workflow, React Flow opens the Activity page. A large job is shown as Processing until all items are done. Open the run to see how many items were processed, for example "4 successes / 4 resources", together with the sort, limit and query that were used.

To stop a run that is still processing, open it on the Activity page and click Disable.

✔️ Next step

Check our articles to learn more about the app's functionality:

• How runs are counted in React Flow
• Activity page
• Components of the workflow

Updated on: 20/10/2026