A Gen Product Options
Menu
Storefront and orders

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:

OptionSaved as
Choice optionsThe 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 quantityEach value with its quantity, for example “Chocolate bar × 3 (+$4.00 each)”.
Text and other inputsWhat the shopper typed, with the price when Show price next to values is on.
File uploadThe link to the uploaded file.
Price formulaThe 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:

  1. In your Shopify admin, open Settings › Checkout › Checkout rules.
  2. 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

Stuck on something?

Check Troubleshooting, or email us with your store URL and we’ll help.

Email support

    Search titles and headings, for example “formula” or “swatch”.