Troubleshooting
Rule matches no variants
When the live preview is empty — usually a conditions problem.
If the Browse preview is empty (or you see the alert "Rule matches no variants — check your filters"), your conditions don't match anything in your current catalog.
Most common causes
1. AND logic is too restrictive
Your conditions are combined with AND, meaning every condition must match. The more conditions you stack with AND, the fewer variants will qualify.
Example:
Collection is "Summer" AND Tag is "clearance" AND Color is "Red" AND Inventory ≤ 5
If even one of those isn't true for a variant, it doesn't match. Try removing one condition at a time and re-browsing to see which one is filtering everything out.
2. Tag misspelling
Tags are case-insensitive but otherwise must match exactly. Common slip-ups:
- "Clearance" vs "Clearance " (trailing space)
- "summer" vs "Summer" (case mismatch — actually fine, tags are case-insensitive)
- "summer-2026" vs "summer 2026" (hyphen vs space)
Open one of the products you expected to match and check its actual tags in Shopify admin.
3. SKU mismatch (case-sensitive)
Unlike tags, SKUs ARE case-sensitive. TSHIRT-RED and tshirt-red are different.
4. Inventory threshold higher than actual stock
Condition: Inventory ≤ 5. If everything in your catalog has 50+ units in stock, nothing matches. Either reduce stock first, or change the threshold.
5. Product Option name typo
Product Option conditions need the exact option name your products use:
- Some products use
Color, others useColour— they're treated as different options - A condition
Color is "Red"won't match products that useColour
Standardize option naming, or use a separate condition per spelling.
6. Empty collection
The collection you picked doesn't have any products in it (yet). Add products to it in Shopify, or pick a different collection.
7. Operator confusion
is one of requires the value to be in a list. If you accidentally typed values into a single-value field that expects is, the match might silently fail. Re-pick the condition operator from the dropdown.
Diagnostic workflow
- Open the rule and click Browse — confirm 0 matches
- Remove the last condition you added — Browse again
- Keep removing conditions one at a time until matches start appearing
- The condition that broke matching when added is the one with the issue
- Verify that condition's field, operator, and value against actual products in your catalog
When to use the home page alert
The "matches no variants" alert on the Home page appears when an Active rule has empty matches. Common scenarios:
- You activated a rule before adding products to a target collection — fix by adding the products
- Inventory dropped to zero on all matched variants — fix by deactivating or adjusting threshold
- A tag was renamed in Shopify — fix the rule's tag value
The fix link routes you to the rule editor with the problem rule open.