• PAYMENT OPTIONS & PARTIAL PAYMENTS • SETUP GUIDE

Understanding Collection Eligibility Limitations in Shopify Checkout

Understanding Collection Eligibility Limitations in Shopify Checkout

When setting up rules for Cash on Delivery availability, COD fees, or partial deposit requirements, merchants often wonder: *"Why can I select individual products, product tags, and variants in Rivio, but cannot target smart automated collections directly?"*

This is not a bug or a missing feature in Rivio—it is an architectural design constraint imposed by Shopify's modern Checkout Architecture (Shopify Functions).

In this guide, you will learn the technical reasons behind this platform limitation and the best practice strategies to organize your catalog without sacrificing automated rule management.


Before You Begin

Before reviewing collection limitations, ensure that:

  • You understand how Shopify Functions operate at native checkout.
  • You have reviewed your current product taxonomy (tags, types, and vendor names) in Shopify Admin → Products.

Step-by-Step Instructions

How to Use Product Tags to Replace Automated Collections

Because Shopify Functions do not evaluate collection memberships at checkout, using Product Tags is the official and most reliable method to manage dynamic rule groups.

  1. In your Shopify admin, navigate to Products.
  2. Select all products that you want to include in your Cash on Delivery or partial deposit policy.
  3. Click More actions → Add tags.
  4. Enter a clean, standardized tag such as cod-deposit-required or no-cod.
📸 SCREENSHOT PLACEHOLDER: SC-COD-029

Shopify Admin bulk product editing showing the addition of a custom tag

Shopify Admin bulk product editing showing the addition of a custom tag
  1. Open Apps → Rivio COD & Partial Payments.
  2. Navigate to Payment Options (or COD Verification).
  3. Under the Eligibility Conditions section, choose Product Tag.
  4. Select or enter the tag you created in Step 4 (cod-deposit-required).
  5. Click Save Changes in the upper-right corner.
📸 SCREENSHOT PLACEHOLDER: SC-COD-030

Rivio COD rule settings showing product tag matching rule configured

Rivio COD rule settings showing product tag matching rule configured

Technical Context: Why Shopify Built It This Way

Shopify checkout processes billions of dollars in peak holiday traffic without dropping a single transaction. To achieve sub-millisecond execution speeds:

Architecture Layer Legacy Checkout (liquid) Modern Shopify Functions (WebAssembly)
Execution Environment Server-side Ruby runtime Lightweight WebAssembly sandbox on edge CDN
Collection Lookups Allowed slow database joins Database collection queries blocked to protect latency
Data Payload Available Heavy, unbounded object graphs Tight, pre-filtered Cart Lines (ID, Variant, Tags, Type, Price)
Checkout Speed 800ms - 2,500ms Under 50ms globally

Because collection queries require looking up nested relational databases across thousands of automated condition filters, Shopify intentionally restricts Checkout Function payloads to direct line-item attributes: Product ID, Variant ID, SKU, Product Tag, and Product Type.


Example Scenario

Migrating a "Clearance Sale" Automated Collection

A sports retailer creates a smart automated collection in Shopify called "Clearance Sale" containing 300 discounted shoes. They want to disable Cash on Delivery on all clearance items. Instead of attempting to link the collection, they use Shopify's bulk editor to add the tag clearance-no-cod to the items. In Rivio COD, they select Product Tag: clearance-no-cod as an exclusion rule. The restriction executes instantly at checkout with zero performance delay.


Important Notes & Limitations

When you use automated Shopify tools like Shopify Flow or automated CSV bulk imports, you can automatically add tags whenever a product is added to a collection.

If you edit an automated collection's rule criteria, remember to update the corresponding product tags so Rivio's checkout rules remain perfectly aligned.


Troubleshooting

Products added to a collection still allow restricted payment methods

  • Possible Cause: The merchant attempted to filter by collection name instead of syncing product tags.
  • How to Fix:
  1. Open the product in Shopify Admin → Products.
  2. Confirm that the exact product tag configured in Rivio COD is present on the product record.

Newly published products in the collection do not trigger the rule

  • Possible Cause: Automated tagging did not run for the new product.
  • How to Fix:
  1. Check your Shopify Flow tagging workflow, or manually add the product tag to the new product before publishing.

Related Guides


Need Help?

Have questions about setting up automated product tag workflows for your collections?