# Variant Drawer issues

## 1. Drawer trigger not appearing on the product page

**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.

***

## 2. Drawer opens but shows a spinner that never stops

**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.

***

## 3. Styling looks different from the admin preview

**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:

```css
.orb2b-drawer-title { color: #333 !important; }
```

**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.

***

## 4. Action buttons (Add to Cart / Start Order) not showing

**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.

***

## 5. Labels not translating on the storefront

**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.

***

## 6. MOQ validation not working

**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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://orbit-b2b.gitbook.io/orbit-b2b-docs/faq-and-troubleshooting/variant-drawer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.