Get draft order data
In workflows that use draft order data, you can use theGet draft order dataaction to retrieve draft order information from your store. You can use this action in any workflow, including theScheduled timetrigger. In a workflow that uses theScheduled timetrigger, the workflow starts at a time that you've specified, rather than as a result of an event. Because there is no specific event in your store or from an app that starts the workflow, there is no data automatically included.
On this page
Fields
TheGet draft order dataaction contains the following fields.
| Field | Description |
|---|---|
| Sort data by | Required. The parameters by which the data returned by the search query is sorted. |
| Maximum number of draft orders | Required. The maximum amount of draft orders that can be returned by the search query that you select. |
| Select a query to filter data | Required. The search query that obtains the data to be used in the workflow. SelectAdvancedto create your owndraft orders queryby using Shopify's APIsearch syntax. |
| Edit query | The search query that's used to select draft orders. This query can be edited to customize the results. |
Returned data
TheGet draft order dataaction itself doesn't take any direct action in your store. Instead, it extracts data from your store based on your query, and makes this data available for use in subsequent steps in your workflow.
When you add aGet draft order dataaction to a workflow, steps that follow this action have aGet draft order datavariable available in the variable picker. To use the data extracted by your query in following conditions or actions, selectGet draft order datain theReturned datasection of the configuration panel. For custom created variables, use thegetDraftOrderDataobject.
Triggers
TheGet draft order dataaction can be used in any workflow.
Example
In this example workflow, a workflow is scheduled to run every Sunday at 9:00 am. TheGet draft order dataaction is used to collect data for draft orders created in the last week. If the total amount of a draft order is equal to or greater than 500 USD, an internal email is sent to review the draft orders.