How To Set-Up this Orderbot Action

  1. Click + Add Action

  2. Select "Add Order Item To Order"

  3. From the second dropdown, select a sales channel option. The only channels that will populate are ones that this action can apply to. If your sales channel is not listed there, it is not eligible for this action.

  4. Specify the Listing SKU for the sales channel to add to the order.

  5. Set the Unit Price that will be included in the order

  6. Set the Quantity to add for the SKU

  7. Optional: Set any Discount for the product added

  8. Optional: Add Notes for the Order Item

Note: You can but do not need to set up a filter for this action to apply.


Behavior: When the action applies, it will compile all fields from the orderbot action page to generate an order item and add it to the order as long as the sales channel for the order equals the sales channel from the orderbot action, otherwise it will simply skip over. Continue reading to understand how this action performs in terms of the sequence of orderbot application.


Limitation: At this time, this orderbot will only be supported for channels that allow editing order items, which are Manual Channels and Shopify.

Action Sequence

The "Add Order Item to Order" orderbot has a specified place in the sequence in which orderbots apply to qualifying orders.

  • This article refers to this orderbot as the "Add Item" orderbot. This article also refers to the Mark Order as Shipped orderbot action as the "Mark Shipped" orderbot.

  • Orderbot Rank application always starts with the lowest rank number first. For example, Rank 1 always applies first, then Rank 2, then Rank 3, etc.

  • If there is more than one Add Item orderbot, they will be handled according to rank.

  • As with any orderbot action, the orderbot will only apply if its filters are met.

Why does a specified sequence in orderbot processing matter?

  • This matters because orderbot flows are extremely customizable. In an orderbot flow, orders are edited with each orderbot that applies. Therefore, if you had a flow that was contingent on a certain product being a part of the order or not, and you use the Add Item orderbots to make sure that product is included in an order, then you might expect your full flow to apply after the Add Item orderbot takes effect. Given the following details, that would not be the case, so you should customize your workflow with a different strategy.


There are two ways to understand the sequence in which this particular orderbot will apply.

First Sequence- ‚ÄčIf there ISN'T a Mark Shipped orderbot in the flow

  1. Orderbots in any rank will apply, according to Rank, completely ignoring the Add Item orderbot(s).

  2. The Add Item orderbot applies. If there is more than one Add Item orderbot, they will apply according to rank.

  3. Orderbot processing ends.

Example: I have a Rank 1 Add Label orderbot, Rank 10 Add Item orderbot, Rank 15 Set Warehouse orderbot, and Rank 20 Add Item orderbot.

In this case, if all orderbots qualify to apply, then the sequence would be:

  1. Add Label applies

  2. Set Warehouse applies

  3. Add Item applies (Rank 10)

  4. Add Item applies (Rank 20)

This example shows that although the Rank 10 Add Item orderbot has a lower number rank than the Rank 15 Set Warehouse orderbot, the Set Warehouse action will apply before it because the Add Item orderbot is completely ignored until after all other orderbots have applied.



Second Sequence- ‚ÄčIf there IS a Mark Shipped orderbot in the flow

  1. Orderbots in any rank that come before the Mark Shipped orderbot will apply according to Rank, completely ignoring the Add Item orderbot(s).

  2. Now the process considers which Add Item orderbots to apply.

    1. IF the rank of the Add Item orderbot is the same rank or a lower number than the rank of the Mark Shipped orderbot, then the Add Item orderbot will apply.

    2. IF the Add Item & Mark Shipped orderbots are in the same rank, then the Add Item orderbot will apply first. (Any other orderbots in the same rank will apply before both the Add Item & Mark Shipped ones.)

    3. IF the rank of the Add Item orderbot comes after the rank of the Mark Shipped orderbot, then the Add Item orderbot will NOT apply.

  3. Finally, the Mark Shipped orderbot applies. This automatically ends all orderbot processing, regardless of if there are more orderbots of any kind in any rank that come after.

Example: I have a Rank 1 Add Label orderbot, Rank 10 Add Item orderbot, Rank 15 Set Warehouse orderbot, Rank 20 Mark Shipped orderbot, Rank 25 Add Label orderbot, and Rank 25 Add Item orderbot.

In this case, if all orderbots qualify to apply, then the sequence would be:

  1. Add Label applies

  2. Set Warehouse applies

  3. Add Item applies (Rank 10)

  4. Mark Shipped applies (Rank 20)

This example also shows that although the Rank 10 Add Item orderbot has a lower number rank than the Rank 15 Set Warehouse orderbot, the Set Warehouse action will apply before it because the Add Item orderbot is completely ignored until after all other orderbots have applied.

However, it also shows that both the Rank 25 Add Item orderbot and the Rank 25 Add Label orderbot do NOT get applied. This is because any orderbot whose rank comes after the Mark Shipped orderbot does not get to apply since the Mark Shipped orderbot ends all orderbot processing.

Did this answer your question?