Workflow Actions Reference
Each workflow action picks a field and an operation. Which ones you can choose depends on the workflow's event. For events, plans and testing, see Workflow Events, Plans and Testing.
Product workflows
Fields you can change
Product Brand, Product Suggested Price, Product User Field 1 to 10, Product Tags (local), and, if your store supports them, Product Tags (remote) and Product Metafields.
Value operations
| Operation | What it does |
|---|---|
| Set to Value | Replaces the field with the value you type |
| Change by % | Raises or lowers the field by a percentage |
| Add Value / Subtract Value | Adds or subtracts a fixed amount |
| Set To Field | Copies another field, for example MAP into Suggested Price |
| Add to Field / Subtract from Field | Adds another field's value to this field, or subtracts it |
| Set to % of Field, Set to % Markup of Field, Set to % Off of Field | Enter a percentage and pick another field. Sets this field to that percentage of the other field, that percentage above it, or that percentage below it |
| Round Up Value with Increment | Rounds up to the next price ending in your increment (0 to 0.99). With 0.99, 6.89 becomes 6.99; with 0.75 it becomes 7.75 |
Special actions
- Apply Product Template: type the template's name. Matching products use that template. This is also the only action for Add Product from Catalog workflows. See Product Templates.
- Disable Price Update: keeps the matching products at their current price, so no price update is sent. They show as Price Updates Disabled on the Pricing page. Use it on Product Costs Changed workflows.
- Set Inventory to Zero: while the workflow is on, matching products are pushed to your store with 0 stock. Cost, MSRP and MAP updates keep flowing. Switch the workflow off and the real quantities return on the next inventory update.
- Set Stock Minimum: enter a quantity. While the workflow is on, matching products whose vendor quantity is below it are pushed as out of stock (0). It only raises minimums: the vendor's own Stock Minimum still applies and the higher of the two wins. Product events only. See Control Inventory Minimum and Maximum Quantities.
- Add Tag / Remove Tag: on Product Tags (local) (kept in Spark Shipping) or Product Tags (remote) (in your store).
- Set Metafield: on Product Metafields, enter the metafield key and a value. A date written as YYYY-MM-DD is saved as a date; anything else as text. A blank value removes the metafield.
- Set Metafield from Field: the same, taking the value from another field.
Switching on a workflow with Set Inventory to Zero or Set Stock Minimum applies it across your catalog right away.
Vendor SKU workflows
These change one vendor's SKU before its values combine into the product: Vendor SKU Brand, Vendor SKU Category(ies), Vendor SKU Stock, Vendor SKU MSRP, Vendor SKU MAP, Vendor SKU Unit Cost, Vendor SKU Shipping Cost Avg, Vendor SKU Shipping Cost Flat, Vendor SKU User Field 1 to 5 and Vendor SKU Notes.
The same operations are available, except Set Stock Minimum. Set Inventory to Zero works here too: if any of a product's vendor SKUs matches, the whole product is pushed as 0.
Order workflows (Premium)
Order Imported workflows can Set to Value, Set To Field, Add Value or Subtract Value on Internal Notes, Order User Field 1 to 4, the shipping name, company, address, city, state, ZIP, country and phone, Order Item Status (all items) and Order Item User Field 1 to 4 (all items). Setting Order Item Status to On Hold holds the order.
They also have three special actions:
- Add Line Item: adds a fixed line to the order, such as a handling fee your vendor charges. Fill in SKU (it can't match a live product on the site), Description, Price (per unit, recorded as the vendor cost and the line price; your customer isn't charged), Quantity (usually 1) and Vendor (whose order will carry the line). Spark Shipping creates an internal product for it the first time; it isn't pushed to your store.
- Send Email Alert: emails the site owner's notification address (set on your profile page). Add an optional Message, for example "Large order — call the vendor before shipping."
- Process Order (skip On Hold rules): matching orders skip your site's hold rules and go straight to your vendors. Other orders are still held. Things to know:
- If any one item matches your conditions, the whole order is released.
- Orders held as possible fraud, or because they're older than your fulfillment cut-off, are never released by this action.
- When a product is mapped to several vendors, the vendor condition reads them as one list (for example "Rothco, Kroll"), so use Contains rather than Equals, and match the vendor name's capitalisation.
- Conditions are checked again when the order is sent, after the workflow's other actions, so don't pair it with an action that changes a field your conditions test.
- If the same workflow sets Order Item Status, that wins: On Hold keeps the order held.