Variant Drawer issues
Last updated
Was this helpful?
Check the app block: Go to Shopify Admin → Online Store → Themes → Customize → navigate to a Product page template. Verify that the Variant Drawer Trigger block is added and visible.
Check the rule status: Open the rule in the app. Make sure Status is set to Active.
Check customer eligibility: If the rule targets specific customer tags or groups, verify that:
You are logged in as a customer with the matching tag
Guest visitors won't see tag-targeted rules
Check the customer's tags in Shopify Admin → Customers
Check product eligibility: If the rule targets specific products, collections, or product tags, verify that the product you're viewing matches the rule's product scope.
Check priority conflicts: If multiple rules exist, only the highest-priority matching rule is applied. A lower-priority rule may be hidden by a higher-priority one with different display settings.
Check the app backend: The drawer sends a request to the app's backend to resolve the matching rule. If the backend is down or unreachable, the spinner will hang.
Check the Shopify API connection: Verify that the app's access token is valid. Try opening the app in Shopify Admin — if the dashboard loads, the connection is fine.
Check browser console: Open the browser Developer Tools (F12) → Console tab. Look for network errors or JavaScript errors with variant-drawer in the message.
Theme CSS conflicts: Some themes have aggressive CSS that can override the drawer's styles. The drawer uses .orb2b- prefixed classes to minimize conflicts, but overrides can still happen.
Solution: Use the Custom CSS field in the Design section to add !important overrides for specific properties. For example:
Metafield out of sync: Design settings are stored in a metafield. If the metafield wasn't synced properly, open the rule in the editor and click Save again to trigger a re-sync.
Check Display & Actions settings: Open the rule → Display & Actions. Make sure at least one action is enabled (Add to Cart or Start Order).
Legacy rules: Rules created before the actions feature was added may not have actionsEnabled set. Edit the rule, enable the desired actions, and save.
Check locale is published: Go to Shopify Admin → Settings → Languages. The target language must be Published (not just added).
Check translations are saved: In the rule editor, switch to the target locale using the toolbar dropdown. Navigate to Labels and verify that translations are entered. Empty fields fall back to the primary locale.
Force re-sync: Open the rule and click Save to re-sync translations to the metafield.
Check constraint values: Open the rule → Order Constraints. Verify that MOQ values are greater than 0. A value of 0 means "no minimum."
Check that constraints are not conflicting: If MOQ per variant is greater than Max per variant, the constraint is impossible to satisfy. The editor shows a warning banner for this case.
Last updated
Was this helpful?
Was this helpful?
.orb2b-drawer-title { color: #333 !important; }