Send additional properties about the product along with order items

Topic summary

A developer building a Shopify storefront with the Hydrogen framework needs to pass custom data at the line item level for internal order processing. The data must be:

  • Attached to orders at the item level
  • Retrievable via webhooks and GraphQL
  • Hidden from customers during checkout

Currently, custom line item properties appear on the checkout page, which is undesirable since Shopify doesn’t allow standard checkout customization.

Solution provided: Make line item properties private by prepending an underscore to the property name (e.g., properties[_hiddenPropertyName]). This prevents the data from displaying to customers while keeping it accessible through Shopify’s API.

The discussion appears resolved with this straightforward workaround.

Summarized with AI on October 27. AI used: claude-sonnet-4-5-20250929.

Hi All,

We are currently building our storefront using the Hydrogen framework and would like to pass some additional information at the line item level in our Shopify store.

To achieve this, we are adding custom data under line item properties, which is later consumed by our internal order maintenance system via Shopify webhooks and GraphQL queries.

However, we’ve noticed that these properties are displayed on the Shopify checkout page under each product, which is not desirable as the data is intended solely for internal processing. Since Shopify does not allow customization of the standard checkout page, we’re exploring alternative approaches.

Our main requirement follows:

  • The custom data should be attached to the order (at the item level),
  • It should be retrievable through webhooks and GraphQL,
  • But it should not be visible to the customer during checkout.

Is there a recommended approach or workaround for this?

Hi @kanagavela :waving_hand: just make the line item properties private by prepending the property name with and underscore

e.g. properties[_hiddenPropertyName]

https://shopify.dev/docs/api/liquid/objects/line_item#line_item-properties