Flow Automation: Adding Products to Orders via Action
You can use the Add product to order action in Flow Automation to automatically add specified products to existing orders when preset conditions are met, such as a free gift for orders that reach a spending threshold. With this action, you don’t need to open the order details page to edit products manually.
This guide explains the field descriptions for this action, the applicable triggers, and how to use it in a real-world scenario to automatically add free gifts, reducing manual order editing and preventing missed gifts.
Field Descriptions
The Add product to order action allows you to specify the order to add products to, the quantity, and the product’s SKU code or product ID.
| Field | Description |
| Modify the draft order id , you can edit from call order-start interface return parameters | The order to add products to. Click + Add variables and select [System order number] to insert the order that triggered the workflow. |
| Quantity | The number of items to add. |
| Product id , sku | The SKU code or product ID of the product variant to add to the order. |
Applicable Triggers
The Add product to order action is commonly used in workflows initiated by the following triggers:
- [Order] Order creation
- [Order] Order paid successfully
| Note: For more details on how to set up the Order creation and Order paid successfully triggers, please refer to "Flow Automation: Triggering Workflows When an Order Is Created"and "Flow Automation: Triggering Workflows When an Order Is Paid." |
Example Use Case
Here is a practical example of using the Add product to order action to automatically add a free gift to qualifying orders.
Scenario: After an order is paid, if the order amount reaches the promotion threshold, automatically add a free gift to the order and add an order tag reminding the warehouse to ship it with the order.
- Trigger: Order paid successfully
- Condition: Amount greater than or equal to 100 (set the amount according to your store’s promotion rules)
-
Action 1: Add product to order
- Modify the draft order id , you can edit from call order-start interface return parameters: [System order number]
- Quantity: 1
- Product id , sku: Enter the SKU code or product ID of the gift variant you created in advance (with the price set to 0)
-
Action 2: Update Order Note
- Order number: [System order number]
- Notes: Gift reminder: A free gift has been automatically added to this order. Please ship it with the order.
- Outcome: Orders that reach the threshold automatically get an extra gift line item and a reminder tag, so the warehouse can pick items by order without missing any gifts.
| Note: To insert the information shown in square brackets (such as the system order number), click + Add variables and select the corresponding parameter. |
Usage Limits & Notes
- A new line item is added every time: Even if the order already contains a product of the same variant, the action adds it as a separate line item.
- The order is recalculated: After products are added, the order total is recalculated. For free gifts, we recommend using a gift product priced at 0 so the order total doesn’t increase.
- Some orders don’t support product editing: For example, orders that have been paid and fulfilled, subscription orders, and local delivery or store pickup orders. For details, refer to "Editing Items in Existing Orders."