How to Show Shopify Checkout Blocks Based on Cart Contents
What you will achieve in this guide
Follow the feature-specific setup and testing instructions below. Check the supported pages and plan requirements before activating the feature.
Display conditions control who sees a saved block and when it appears. They do not add the block to the editor.
How this feature works
Cart-content conditions test the supported product/variant/cart inputs on an eligible surface. A qualifying product in the cart is different from a product merely viewed or purchased previously. Profile ignores cart/order conditions.
Before you begin
Checkout-step visual blocks require Shopify Plus. Supported Thank you and Order status blocks are available on Basic and higher. Check the page labels on the block’s Rivio card; a card does not necessarily support every page.
Worked example: Show a message when a preorder item is present
Example setup: Demo Preorder Jacket and an unrelated shirt.
Step-by-step instructions
Open UI extension blocks and edit a supported Custom banner configuration.
Enter the demonstration message and confirm the target page supports this condition.
Choose the supported cart/product condition and select Demo Preorder Jacket. Use the message Your preorder ships in 2 weeks.
Review all/AND versus any/OR only where the form exposes grouping controls. Use one condition for the first test.
Save as Active and confirm the banner is placed and saved on the exact Shopify editor page.
Run each matching and non-matching case on the actual customer page. Keep cart and customer context constant except for the input being tested.
Verify the result
| Test case | Expected result or verification |
|---|---|
| Cart contains jacket | The supported cart-page condition matches. |
| Shirt-only cart | The message is hidden. |
| Profile page | Cart/order conditions are ignored there, so do not use Profile for this demonstration. |
If the result is different
| Check | What it means / what to do |
|---|---|
| Unexpected buyer sees content | Review all/AND versus any/OR and the selected condition values. |
| Customer tag does not match | Test with the intended logged-in customer; anonymous checkout may lack tag context. |
| Condition works on another page only | Check the page’s supported inputs; Profile ignores cart/order conditions and Order status lacks selected shipping method. |
Check page-specific data
Customer-tag conditions require logged-in customer context. Selected shipping method is unavailable on Order status. Days since order is available only on Thank you/Order status. On Profile, only Customer, Language, Market, and Time on page conditions are evaluated; cart/order conditions are ignored.
Related guides
- How to Show Shopify Checkout Blocks Based on Device
- How to Show Shopify Checkout Blocks Based on Customer Tags
- How to Show Shopify Checkout Blocks Based on Order Value
Need help?
Email support@rivioapps.com with your store domain, feature name, target page, the relevant settings, and a screenshot of the actual result. Include the test cart, customer, or order details needed to reproduce the issue.
Screenshot reference
Screenshot to add: The saved settings described in this guide, with its selected conditions or scope visible.
Screenshot to add: The worked example’s actual customer result or saved Shopify record, including the relevant test inputs.
Was this article helpful?
Your feedback helps us continuously improve our setup guides and documentation.
Thank you for your feedback! Our documentation team reviews all suggestions.