Bulk Operation Workflows

Bulk Operations are workflows that are manually started from within the app and can process an unlimited number of items. The app currently supports Bulk Operations for Product, Variant, Order, Draft Order, Customer, Collection, Dispute and Custom workflows.

The Workflow Variables system works with Bulk Operations workflows to collect dynamic data as part of starting a Bulk Operation workflow. See Workflow Variables (linked below) to learn more about this system. 

Creating a Bulk Operation Workflow

  1. From within the app, click on Workflows in the left sidebar.
  2. Click Create Workflow in the top right.
  3. Choose Workflow Type of Bulk Operation.
  4. Choose an Object Type, such as Products and click Create Workflow.
  5. Configure your workflow and turn it on.

Starting a Bulk Operation

  1. From within the app, click on Workflows in the left sidebar.
  2. Click the title of the workflow to run.
  3. From the workflow page, in the top right of the workflow, click the checkbox list icon in the triggers area of the workflow next to "When the [X] workflow is Run in A Bulk Operation".
  4. On the Run Bulk Operation page, use the filters to narrow the results list and select items to process using the checkboxes on the left side of the list. For more information on filtering & selecting items, see below.
  5. Scroll to the bottom of the list and click Continue.
  6. Confirm selections and click Run Workflow Now.

Stopping a Bulk Operation

  1. From the workflow page, in the top right of the workflow, hover on the 3 dots menu.
  2. Click Run Bulk Operation.
  3. Click Cancel Job.

Viewing Job Data 

  1. From the workflow page, in the top right of the workflow, hover on the 3 dots menu.
  2. Click Log Messages.
  3. Click the Jobs tab.

Data regarding completed and in-progress Bulk Operations is listed on this page. 

Filtering Job Items 

Use filters to reduce the number of items fetched for processing. Items are then processed to the workflow and any workflow conditions are applied.

Saved Searches
Filter options include Saved Searches (sometimes called Views or Segments) from the Shopify interface, as well as general searches and advanced filters. Shopify's Saved Searches may also be combined with in-app filters. Simply select the Saved Search you'd like to use, then use any of the in-app search options to further narrow the results.

Advanced Search Filters
Bulk Operations include a basic search as well as specific filters, such as Title, SKU, etc. 

GraphQL Queries
To add a GraphQL query as a filter:

  1. Go to the Run Bulk Operation page for the workflow.
  2.  Click on Advanced.
  3. Click + Add Filter
  4. Select Advanced Query.
  5. Enter the GraphQL query to be performed. More information about getting started with Graph queries can be found here.

Batch Quotas

Items fetched for processing in Bulk Operations impact available Daily Quota. Quota is simply the number of items that can be retrieved for processing. 

Jobs in progress will lower available quota and will lock the quota they need in order to finish the Job. If a Job cannot be completed due to insufficient quota, the Job stops and the locked quota is returned to the available pool. Job that cannot complete due to insufficient quota will not run any items at all to avoid partially completing the job.