# Line Item Properties

Line item properties let you attach custom key-value data to individual products in a draft order. Essential for customization, special instructions, and tracking.

### What they are

* **Key** - Property name (e.g., "Engraving", "Gift Message")
* **Value** - Property data (e.g., "Happy Birthday", "Handle with care")

Properties are visible to customers on invoices and stored with the order when completed.

### Common use cases

* Product personalization (engraving, custom colors, sizes)
* Special instructions (gift wrap, shipping notes)
* Order tracking (SKUs, PO numbers, department codes)
* B2B metadata (cost centers, GL codes)

### Adding line item properties

#### Add a property manually

1. Open a draft order in the editor
2. Find the line item you want to add a property to
3. Click **Add property** button on that line item
4. Enter the **Key** (property name)
5. Enter the **Value** (property data)
6. Press **Enter** or click **Save**
7. The property appears below the line item

\[Video: Adding a line item property - 20 seconds]

#### Add multiple properties to one item

You can add as many properties as needed to a single line item:

1. Click **Add property**
2. Enter first key-value pair
3. Click **Add property** again
4. Enter second key-value pair
5. Repeat as needed

\[Screenshot: Line item with 4 different properties]

#### Edit existing properties

To modify a property:

1. Click on the property's key or value
2. Edit the text
3. Press **Enter** or click outside to save

#### Remove properties

To delete a property:

1. Find the property on the line item
2. Click the **trash icon** or **X** next to it
3. The property is removed immediately

{% hint style="warning" %}
Removing a property is permanent for that draft order. Make sure you want to delete it before confirming.
{% endhint %}

### Using property templates

If you frequently use the same properties, create templates:

#### Apply a template

1. Click **Apply template** on a line item
2. Select a saved property template
3. All properties from the template are added at once

[Learn more about property templates →](https://github.com/horselditty/draft-order-docs/blob/main/product/templates/line-item-templates/README.md)

#### When to use templates

Templates are ideal for:

* Standard customization options (e.g., engraving, gift wrap)
* Repeated order configurations
* B2B tracking fields that don't change
* Complex bundles with multiple items

### Where properties appear

Properties show in:

* Draft Order Magic editor
* Shopify draft order details
* Invoice emails and PDFs
* Completed orders
* Packing slips
* Shopify reports

{% hint style="info" %}
Customers can see line item properties on invoices. For internal-only notes, use [order attributes](https://github.com/horselditty/draft-order-docs/blob/main/product/editor/order-attributes/README.md) instead.
{% endhint %}

### Properties vs. attributes

Line item properties are attached to specific products and visible to customers. For order-level data that's internal only, use [order attributes](https://github.com/horselditty/draft-order-docs/blob/main/product/editor/order-attributes/README.md).

### Bulk adding properties

**CSV import:** Include properties in your CSV with `Property_Name` columns.

[Learn more about CSV import →](https://github.com/horselditty/draft-order-docs/blob/main/product/editor/csv-import/README.md)

**Templates:** Create and apply property templates for repeated configurations.

[Learn more about templates →](https://github.com/horselditty/draft-order-docs/blob/main/product/templates/line-item-templates/README.md)

### Troubleshooting

**Properties not showing in Shopify:**

* Refresh the page
* Verify draft order was saved
* Check Shopify draft order details

**Properties not on invoice:**

* Check your Shopify invoice template
* PDF invoices from Draft Order Magic always include properties

**Can't edit property:**

* Ensure draft order isn't completed
* Try refreshing the page

**Property truncated:**

* Keep keys under 50 characters
* Keep values under 500 characters

[More troubleshooting →](https://github.com/horselditty/draft-order-docs/blob/main/support/troubleshooting/README.md)

### What's next?

Add custom data at the order level Save time with reusable property sets Import items with properties in bulk Generate invoices that show all properties


---

# 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://responsive-media.gitbook.io/draft-order-magic/draft-order-editor/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.