Troubleshooting Guide — RUTHH COD Form & Upsells

Quickly diagnose and resolve common configuration or operational issues across the storefront COD form, server admission gates, shipping rates, fraud rules, and integrations.

• Access to your RUTHH COD Form & Upsells Admin workspace in Shopify Admin.

1. Check Theme App Embed Activation: Open Home (/app) and confirm the Theme App Embed badge is Active. If inactive, click Enable in Theme Editor and save your live theme.
2. Check Display Surface (displaySurface): Open Settings → Visibility (/app/settings). Verify Form Display is not set to Disabled, and is not restricted to Cart page only while testing a product page (or Product pages only while testing the cart).
3. Check Product & Collection Targeting: Verify the product you are viewing is not in excludeProductGids or a member of an excludeCollectionGids collection (Exclude Always Wins). If includeProductGids or includeCollectionGids has entries, confirm the product is included.
4. Check Order Value Bounds: If you set minSubtotalMinor or maxSubtotalMinor in Settings → Visibility, confirm the product or cart subtotal falls within those bounds in your primary shop currency.

1. This is usually the Fail-Safe Native Button Guard working as designed.
2. Whenever COD is ineligible for the current product, cart mix, buyer country, or subtotal, the storefront coordinator refuses to hide native Shopify purchase buttons so your store does not lose non-COD sales.
3. Once the product/cart satisfies all COD visibility rules, native button hiding applies automatically.

1. This occurs when you save a configuration change in Admin while a buyer (or your own test tab) already has an older revision of the form open.
2. Refresh the storefront page so the browser loads the latest cod_form.v2_snapshot revision and submit again.

1. Open Form Builder → Shipping Rates (/app/form-builder/shipping-rates).
2. Confirm at least one shipping rate covers the selected delivery country and province.
3. Check the rate’s minSubtotalMinor and maxSubtotalMinor conditions—remembering that conditions are evaluated against the discounted merchandise subtotal (after Quantity Offers), not the pre-discount price.

1. Open Fraud Protection (/app/fraud).
2. Check if your test submission triggered Order Velocity Limit (default 3 orders per 24h) or Duplicate Order Detection (default 72h) or exceeded Maximum Product Quantity Limit (1..10).
3. Add your office or test IP address to Trusted IP Addresses in /app/fraud and click Save.

• Visibility & Display Rules
• Configuring COD Shipping Rates
• Fraud Protection, Blocklists & Phone Verification
• Support & Coverage Backlog