MxAddress support
Setup steps, troubleshooting and answers.
Already installed? The setup steps below have one-click buttons on your app's Home page inside Shopify Admin — open the app and use those instead of the theme editor manually.
Setup
- Make sure your store sells and ships to Mexico. In Settings > Markets, add Mexico to an active market, and in Settings > Shipping and delivery, add it to a shipping zone with a rate. Without this, Shopify checkout doesn't offer Mexico as a country, and the widget stays hidden on your storefront.
- Turn on the app embed. In Online Store > Themes > Customize > App embeds, enable MxAddress. This loads the widget script — nothing works until this is on.
- Add the cart block. On the cart page template, add the MxAddress block — usually placed just above the checkout button.
- Add the order-status block (optional). Clears the shopper's saved address once their order is placed.
- Subscribe. The widget stays hidden on your storefront until the subscription is active — a 7-day free trial is included.
Widget isn't showing?
Check these, in order:
- Your store doesn't sell to Mexico — the widget stays hidden until Mexico is in an active market (Settings > Markets). Add it to a shipping zone too (Settings > Shipping and delivery), or checkout can't deliver there.
- App embed is off — it must be enabled separately from the cart block, in Online Store > Themes > Customize > App embeds.
- The cart block hasn't been added to the cart page template yet.
- The shopper is viewing from outside Mexico and visibility is set to "Mexico visitors only" (the default) — change it in the cart block's theme editor settings, or switch to "All visitors".
- The subscription isn't active — the widget is the only thing billing gates; Settings and Analytics stay available either way.
- The widget is turned off in the app's Settings page.
Cart drawer compatibility
MxAddress watches for the most common cart-drawer patterns (element names and classes containing "cart-drawer", plus the usual drawer-open events themes fire) and injects the same widget there, keeping whatever address was already picked in sync between the cart page and the drawer. A heavily customised or unusual drawer implementation may not be detected — if so, the cart-page widget still works normally, and telling us the theme name helps us add support for it.
What lands where at checkout
| Checkout field | Comes from |
|---|---|
| Postal code | The 5-digit code typed in |
| City | Municipio, from the postal code |
| State | Resolved from the postal code |
| Country | Mexico, always |
The shopper types the street, numbers, colonia and phone in Shopify checkout itself. If no postal code was looked up, checkout opens normally with nothing prefilled — a shopper is never blocked by the widget.
How long is an address remembered?
A saved address is kept in the shopper's own browser for 4 hours, so it survives navigating between the cart and checkout, or a short break and a reload. It's cleared automatically once an order is placed, or if a shopper clears it manually.
Data and privacy
MxAddress requests no Shopify access scopes and cannot read your customers, orders or products. The address a shopper picks is held in their own browser and sent straight to Shopify checkout — never to our servers. We store only your store domain, an encrypted access token, whether the widget is on, your subscription status, and anonymous daily event counters (no address, name or phone in any of it).
Billing and trial
MxAddress is $9.99 USD/month with a 7-day free trial, billed through Shopify. Cancel any time from Shopify's subscription management in your admin — the widget stays hidden on your storefront while unsubscribed, but Settings and Analytics remain available either way.
Contact
Still stuck, or found a bug: devbiz654@gmail.com