Line item properties: product options in the cart, checkout and orders
How shoppers' choices are saved on the cart line, priced at checkout and shown on the order.
Quick answer
Every option a shopper answers is saved on the cart line as a line item property named after the option, so you and your shopper see it in the cart, at checkout and on the order. At checkout a cart function prices the line from your saved options. The optional checks rule stops orders that skip a required option.
Last updated
What's saved on the cart line
When a shopper adds to cart, every option they answered (and that was shown) is saved on the cart line as a line item property, named after the option's label:
| Option | Saved as |
|---|---|
| Choice options | The chosen value names, for example “Gift wrap: Premium (+$12.00)”. Several values are separated by commas. The price is included when Show price next to values is on. |
| Add-on quantity | Each value with its quantity, for example “Chocolate bar × 3 (+$4.00 each)”. |
| Text and other inputs | What the shopper typed, with the price when Show price next to values is on. |
| File upload | The link to the uploaded file. |
| Price formula | The amount it added, for example “+$18.00”. |
The app also adds a property called _agen_opts, which tells checkout which values were chosen. Prices are never taken from the cart: checkout works them out from the options you saved.
At checkout
The cart function reprices each line that has choices to the product price plus the options (see How the price is charged). It also writes the priced choices onto the line, so the order shows exactly what was charged for, even if someone edited the visible properties.
The checkout check
Shoppers can only add to cart once required options are filled in, but a cart can also be filled by other apps or scripts. To stop orders that skip a required option:
- In your Shopify admin, open Settings › Checkout › Checkout rules.
- Add the A Gen Product Options checks rule and turn it on.
Checkout then stops any line that is missing a required option or has an option that no longer exists, with a message telling the shopper what to choose, for example “Signet ring: please choose “Metal”.” It never changes prices.
Note
Checkout can't see variant option names, so it treats options shown by a variant rule as not required. Those are still enforced on the product page.
On the order
The choices are saved on the order's line items, so past orders keep the options shoppers chose, even after you uninstall the app.
Stuck on something?
Check Troubleshooting, or email us with your store URL and we’ll help.
Email support