--- title: "How to arrange metafields on upsell product cards" description: "Choose where product and variant metafields appear, arrange values on the same line, and preview each upsell surface." url: https://docs.orderediting.com/en/articles/15323741-how-to-arrange-metafields-on-upsell-product-cards collection: "Strategies and Configuration" updated: 2026-10-22 language: en --- # How to arrange metafields on upsell product cards Choose where product and variant metafields appear, arrange values on the same line, and preview each upsell surface. # Before you begin Choose compatible Shopify product or variant metafield definitions and give the products or variants you want to preview a value. The definitions need storefront access. Keep units, punctuation, and meaning consistent across your products. Metafield decorations change the content used by supported Order Editing cards, not the original product data in Shopify. Global settings apply across [upsell strategies](/docs/en/collections/18402162-strategies) unless a strategy has its own override. Inventory and out-of-stock rules remain in **Inventory** settings. # Arrange your metafields 1. Open **Apps > Order Editing** in Shopify admin. 2. Open **Upsell settings**, then **Metafield decorations**. 3. Select **Add metafield decorations** or **Edit metafield decorations** to open the dedicated editor. 4. Choose a placement on the product-card diagram, such as **Under the product title**. Its editing controls appear below the diagram. 5. Select **Add metafield** and choose a compatible product or variant metafield. 6. Set **Text before**, **Text after**, and **Color** if the value needs context. For example, place “Ships” before a shipping date. Keep this text short. 7. Add another metafield to the same placement if you want to show two values together. 8. Choose **Side by side** to show the second value next to the first, or **New line** to separate them. 9. Use **Move up**, **Move down**, or **Placement** to reorder or move a mapping. You can also drag its chip onto another chip to pair them. 10. Select **Save** in the page save bar when you are ready, or **Discard** to undo the page's unsaved changes. The diagram remains available if a product preview cannot load. A placement stops offering additional metafields when it reaches its limit. The placement description explains which surfaces support it and where content moves on compact cards. An existing **Under the description** mapping remains editable, even when a compact card shows that content under its price. To remove mappings, select their checkboxes in **Enabled metafields**, then select **Remove selected**. Selecting rows does not disable their metafields. Removal is staged until you select **Save**; **Discard** restores the saved mappings. # If you use the Under the price placement The **Under the price** placement stays available when your saved settings already contain a decoration there. You can edit, pair, move or remove those existing mappings. Removing mappings is staged until you select **Save**. You can select **Discard** to retain the saved placement. A rejected save also retains access. Once you successfully save removal of the last decoration in this placement, the placement and its menu option disappear permanently. Future below-price text and images belong in a line item highlight strategy. After that saved removal, a dismissible **Below-price metafields now use highlight strategies** banner offers **Create a highlight strategy**. Select it to open a new strategy with the line item highlight surfaces selected, or dismiss the banner when you no longer need the reminder. If you have never saved a decoration in this placement, it is hidden. Other placements and replacement behaviors remain available. A saved **Under the description** mapping still follows its surface's placement description, including when a compact card displays it below the price. # Handle products without a value For a variant metafield, select **Add product fallback** to use a product metafield when the variant's value is empty. A product metafield can similarly use **Add variant fallback**. Choose the fallback from the picker and preview a variant without the primary value. If neither source has a displayable value, the label is omitted. To change the primary source, select **Change metafield**; selecting a replacement clears its previous fallback. # Replace default content Use the image or title control in the diagram to replace that detail with a metafield. **Add behavior** in the page title bar offers other supported uses, including variant names, swatch colors, visibility, percentage discounts, and button text. Choose the behavior, then select a compatible definition. A behavior generally has one mapping; image replacement can have both a product and a variant mapping. These choices are separate from ordinary labels, so you can keep adding labels even when all available behaviors are configured. In the title or image dialog, select **Done** to stage your changes on the page, then **Save** in the page save bar. **Cancel** or closing the dialog discards that dialog's changes. Use warning or critical colors only for information that needs a customer's attention. Image metafields must refer to supported Shopify media; the picker disables incompatible value types. # Show benefit lines with checkmarks For a compatible text or list metafield, choose **Checkmark list** as its display treatment. Each list item or line of text becomes a separate row with a green checkmark on supported offer cards. This treatment replaces ordinary prefix, suffix, color and pairing controls. Keep each benefit short. Empty lines are omitted, and the card shows at most five non-empty benefit lines, taking product benefits before variant benefits. Check each placement you use. These product-card benefits are separate from line-item highlight strategies and do not grant a product benefit or discount by themselves. # Preview the result 1. Select **Preview product** in the page title bar and choose a product with known values. 2. Use **Variant** in the title bar to inspect variants with different values or a configured fallback. This menu appears when the product has multiple variants. 3. Use **Surface** in the title bar to compare **Product list**, **Carousel**, **Featured product**, **Checkbox offer**, and **One-click upsell**. 4. Confirm the placement, pairing, text, and colors on each surface you use. The same product and variant stay selected when you change surfaces. This preview checks appearance; it does not prove live targeting, payment, or an order modification. The strategy and branding settings can change the surrounding layout. > **Warning:** **One-click upsell** uses original metafield labels. It does not support image badges, custom pairing, or every color. Check this mode separately before relying on a decoration there. # If values do not appear Check the exact product and variant's saved metafield values and the selected definition's storefront access. Review any mapping warning. If a definition was deleted or became inaccessible, choose a compatible replacement or remove that mapping, then save and preview again. If no compatible definition appears, check its resource type and value type in Shopify. After creating or updating a definition, close and reopen the picker. For a preview-service error, select **Retry preview**. A previous successful preview stays visible with a warning that it may be out of date. Your saved settings are unaffected by that preview error. If the settings themselves fail to load, use **Retry** before editing. ## Related - [How to Customize Your One-Click Upsell Page](https://docs.orderediting.com/en/articles/15323698-how-to-customize-your-one-click-upsell-page.md) - [Upsell Customer Targeting](https://docs.orderediting.com/en/articles/14466316-upsell-customer-targeting.md) - [Understanding Upsell Strategy Matching](https://docs.orderediting.com/en/articles/14391612-understanding-upsell-strategy-matching.md) - [Creating an Upsell Strategy](https://docs.orderediting.com/en/articles/14466314-creating-an-upsell-strategy.md) - [Configuring Upsell Settings](https://docs.orderediting.com/en/articles/14466307-configuring-upsell-settings.md)