# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ordersplitpro-co.gitbook.io/ordersplitpro/basics/how-to-split-by-line-item-properties.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.