Setup POS Cart Attributes — Shop metafields & smart-grid tile

Follow these steps once per store before staff use the app.

Shopify App Store: Install POS Cart Attributes · 繁體中文 listing

0. Select a plan (after install)

When you install POS Cart Attributes from the App Store, Shopify redirects you to choose an App Pricing plan (including any free trial). Approve the plan to activate the app.

If your subscription lapses later, opening the app from Shopify Admin → Apps sends you back to the plan page. POS staff will see a subscription warning on the tile until billing is active again.

1. Install and enable

1. Install POS Cart Attributes from the Shopify App Store.
2. In admin, go to Point of Sale → Settings → POS apps.
3. Enable POS Cart Attributes.

If the app is not enabled here, key lists will not load in POS (modal may show only Other… or Couldn’t load).

2. Create Shop metafields

Go to Settings → Custom data → Shop (or Shop metafields).

See the Tutorials page for step-by-step screenshots (metafields, enable app, add tiles).

Create two metafields under namespace pos_cart_attr:

Cart-level keys (keys)

• Namespace: pos_cart_attr
• Key: keys
• Type: Single line text (List)

Add one row per allowed cart-level key, e.g. OrderRef, CustomerType. Each row becomes an option in the smart-grid tile modal.

Line-item keys (item_keys)

• Namespace: pos_cart_attr
• Key: item_keys
• Type: Single line text (List)

Add one row per allowed line-item key, e.g. SN, Warranty. Each row becomes an option in the line-item attribute modal.

The namespace and key must match exactly. A typo is the most common reason dropdowns show only Other….

Changes to these lists are read live by POS — no app redeploy needed when you edit keys in admin.

3. Add the smart-grid tile

On each POS device:

1. Open the POS home screen.
2. Tap Add tile on the smart grid.
3. Add Cart Attribute (or your renamed tile title).

The tile is not added automatically on install.

4. Verify

Cart-level

1. Add a product to the cart.
2. Tap the Cart Attribute tile.
3. Confirm keys from pos_cart_attr.keys appear, plus Other….
4. Add a test attribute and confirm the tile subheading updates (e.g. 1 attribute added).

Line-item

1. Tap a cart line item → ••• menu → Update cart item attribute.
2. Confirm keys from pos_cart_attr.item_keys appear, plus Other….
3. Save a test value and complete a sale.
4. In admin, open the order and confirm the line-item property is present.

Requirements

• Point of Sale 10.6+
• Localization requires POS 10.19+

Receipt printing (optional)

Per-item attributes can be printed on customized POS Pro receipts via receipt Liquid (line_item.custom_attributes). Cart-level attributes are stored on the order; availability on printed POS receipts varies by store setup. See your receipt template documentation for Liquid examples.