How to split by line item properties

Splitting Orders Based on Custom Line Item Properties

Overview

OrderSplit Pro fully supports splitting orders based on custom line item properties. Line item properties are typically passed from your storefront when customers add items to their cart - for example, custom engraving text, gift messages, or personalization options. OrderSplit can use these properties as splitting criteria.

---

Syntax for Line Item Property Rules

Use the LIP: prefix (Line Item Property) with the following format:

LIP:property_name:property_value

Examples

Splitting Rule	What It Matches
LIP:engraving:John	Line items where engraving equals John
LIP:gift_message:Happy Birthday	Line items where gift_message equals Happy Birthday
LIP:engraving:	Line items that have an engraving property (any value)

---

How It Works

1. Exact Key-Value Match

LIP:gift_message:Happy Birthday

This will match any line item where the property named gift_message has the exact value Happy Birthday.

2. Key-Only Match (any value)

LIP:engraving:

If you use LIP:property_name: (with the trailing colon but no value), it will match any line item that has the specified property, regardless of what the value is.

Important: The trailing colon is required. LIP:engraving: will work, but LIP:engraving will not.

---

Setting Up Split Rules

1. Navigate to the OrderSplit Pro dashboard

2. Create a new split rule

3. In the rule conditions/tags, add your line item property rule:

   • For engraved items: LIP:engraving:

   • For gift items: LIP:gift_message:

4. Save the rule

This configuration will automatically split orders so that items with the specified property are separated into their own order.

---

Important Notes

Case Sensitivity

The property name and value must match exactly as they appear on the line item.

• ✅ If the property is engraving, use engraving

• ❌ Do not use Engraving or ENGRAVING unless that's how it appears in the original property

Verifying Line Item Properties

To verify the property names and values on an order:

1. Open the order in Shopify Admin

2. Look at the line item details

3. Check the "Properties" section for each line item

4. Use the exact property name in your OrderSplit rule

---

Example Use Cases

Scenario	Rule
Split items with custom engraving	LIP:engraving:
Split gift items	LIP:gift_message:
Split items marked as "preorder"	LIP:type:preorder
Split personalized items	LIP:personalization:

---

Need Help?

If you have questions about setting up line item property splitting rules, please contact our support team.