> For the complete documentation index, see [llms.txt](https://docs.webexp.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.webexp.dev/drift-shopify-theme/drift-studio/faq-and-troubleshooting.md).

# FAQ & Troubleshooting

Common issues and how to fix them.

Quick answers to the most common questions and issues.

## Pricing and Currency

### Why does the cart drawer show different prices than my product pages?

This was a real bug we fixed. If you're on **DRIFT Studio v3.1.1 or later**, this should be resolved. If you're seeing it on an older version, update to the latest version of the theme from your purchase email.

The fix: cart drawer now uses Shopify Markets-aware pricing instead of computing prices in JavaScript with the auto-conversion rate. Prices match across product cards, PDP, cart drawer, and quick-add overlay.

### Why does the price change when I click a different size variant?

Same root cause. Fixed in **DRIFT Studio v3.1.2 or later**. Variant clicks now read pre-rendered Liquid prices from the PDP instead of computing them in JS. Update to the latest theme version.

### Some prices show `.00` and I want them clean (no decimals when the price is a whole number)

Fixed in **v3.1.3+**. Whole-number prices like `$50.00` now render as `$50`, while prices with cents like `$49.99` keep their decimals.

## Cart Drawer

### Why are dynamic checkout buttons (Apple Pay, Shop Pay, etc.) stacked vertically on mobile?

Fixed in **v3.1.3+**. They now render side-by-side, max 3 visible. Apple Pay and Shop Pay get priority (they're typically Shopify's first two button slots).

### How do I show recommended products inside the cart drawer?

That's the **upsell carousel** feature. Studio only.

1. Theme editor → **Theme settings** → **Cart Drawer**
2. Enable **Cart upsell**
3. Configure:
   * **Upsell heading** (e.g., "You may also like")
   * **Number of products to show**
   * **Expanded by default — desktop** (separate setting)
   * **Expanded by default — mobile** (separate setting, off by default since mobile space is tight)

Recommendations come from Shopify's `/recommendations/products.json` endpoint. Better store data → better recommendations over time.

## Contact Page

### The Send Message button is cut off on mobile

Fixed in **v3.1.3+**. Contact page now scrolls on mobile when the form is taller than the viewport.

## Email Popup (Pro / Studio only)

### The X close button overlaps the heading text

Fixed in **v3.1.3+**. The X is now positioned above the heading content with proper padding so it never overlaps.

### How do I trigger the popup on a specific page only?

Currently the popup is site-wide. To restrict it to specific pages, you'd need a custom edit. Reach out to us at <contact@webexp.dev> and we can scope it for you.

## Markets / International

### Customers in different countries see prices in their own currency. How do I configure that?

That's Shopify Markets. Set up under **Settings** → **Markets** in your admin.

DRIFT respects Markets natively — currency, language, and shipping rates all switch based on the customer's location/market. The theme handles the display correctly across all surfaces.

### Can I set manual prices per market (instead of auto-conversion)?

Yes — Shopify Markets supports manual market prices. Set them under **Markets** → pick a market → **Pricing**. DRIFT will use those manually-set prices everywhere on the storefront.

If you have manual prices set and you're seeing them displayed wrong somewhere, make sure you're on **Studio v3.1.2+** (this was related to the BUG-002 fix).

## Performance

### My theme feels slow on mobile

A few things to check:

1. **Image sizes** — Shopify's CDN serves multiple sizes, but your source images should be reasonable. 4MB hero images are excessive; 200–500KB is plenty.
2. **Apps** — every Shopify app you install adds JS. Audit your installed apps and remove any you don't need.
3. **Animations** — entrance animations and hover effects are configurable. If you have very long pages, consider disabling some animations.

### Lighthouse scores

DRIFT regularly hits 90+ on Shopify's theme score and Google Lighthouse for Performance, Accessibility, Best Practices, and SEO. If you're seeing significantly lower numbers, the most common culprits are unoptimized images and third-party apps.

## Still stuck?

* Email: <contact@webexp.dev>
* Hire WEBEXP for custom work: [webexp.dev/pages/hire-us](https://webexp.dev/pages/hire-us)
* YouTube tutorials: [@webexp](https://youtube.com/@webexp)