GeoTailor Shopify App Documentation

1. Installation

GeoTailor installs as an embedded Shopify admin app and does not require manual code edits during onboarding.

1. Install GeoTailor from the Shopify App Store listing.
2. Approve requested permissions in the OAuth flow.
3. You will be redirected to the embedded GeoTailor dashboard in Shopify admin.
4. Open Rules or Geo popups to create your first targeting setup.

2. Enable App Embed

The app embed is required for storefront execution of your geo targeting rules and popups.

1. Open Shopify Admin → Online Store → Themes → Customize.
2. Open App embeds from the left sidebar.
3. Toggle GeoTailor Script ON and click Save.
4. Preview the storefront in incognito once to confirm the script is active.

3. Create Geo Rules

Rules target visitors by country and then execute one or more actions in priority order.

• Condition: select country operator and values.
• Actions: Show banner, replace text, hide element, and plan-based advanced actions.
• Status: Active/Inactive toggle for safe rollout.
• Priority: Control execution order for matching rules.

Recommended workflow

1. Start with one country and one action.
2. Use browser Inspect to capture a stable selector.
3. Save as Inactive, verify in preview, then activate.
4. Add extra actions only after the first action is confirmed stable.

Best practices

• Prefer class-based selectors over fragile nth-child selectors.
• Use clear rule names (for example: US Hero Copy).
• Keep a fallback message for countries with no specific rule.

4. Paid Rule Actions

GeoTailor includes additional rule actions on higher plans:

• Block Product by ID (Growth+): block selected products from being purchased for targeted countries/regions.
• Redirect URL (Scale): send visitors from selected countries to another URL (for regional storefronts, market-specific pages, or compliance paths).

Product Blocker behavior

• Use Shopify product IDs (one per line) in the rule action settings.
• GeoTailor blocks blocked products during add-to-cart and checkout attempts for matched locations.
• The blocker is purchase-focused and does not depend on theme-specific product hiding selectors.
• Show a clear shopper-facing message so customers understand why checkout is restricted.

Geo redirection best practices

• Use absolute HTTPS URLs.
• Avoid redirect loops (do not redirect to the same page or a URL that immediately redirects back).
• Test in incognito for each target country segment before enabling broadly.

5. Create Geo Popups

Geo popups are standalone overlays rendered by GeoTailor and targeted by country conditions.

• Choose a template or start from scratch.
• Set country targeting and status.
• Customize style: position, text alignment, CTA labels, delays, and visuals.
• Use plan-available premium templates and layout features as enabled.

Popup launch checklist

• Popup title and body are short and region-specific.
• CTA URL is valid and lands on a relevant collection/product.
• Dismiss behavior and auto-hide settings are intentional.
• Mobile preview is reviewed before enabling.

6. Plan Capabilities

Feature availability by plan (high-level):

• Free: show banner, replace text, hide element, basic popup templates, single-country targeting.
• Starter: higher limits, popup background image/delay, popup block reorder.
• Growth: product blocker action, premium popup templates, split popup layout, higher targeting limits.
• Scale: redirect URL action, advanced exclusion targeting (not_in), secondary popup CTA, unlimited limits.

7. Geo App Blocks

GeoTailor app blocks let merchants add localized content directly from the Theme Editor:

• GeoSection - flexible rich text or custom HTML region.
• Geo Shipping Promise - delivery/returns messaging by location.
• Geo Trust Badges - icon + proof highlights for specific countries.
• Geo Promo Cards - regional campaign cards and links.
• Geo Country FAQ - country-specific Q&A accordion.
• Geo Countdown - localized timed campaign banner.

All blocks use the same country targeting model as rules and popups.

8. CSS Selector Tips

Selectors determine what text or element your rule will modify.

1. Open your storefront in Chrome.
2. Right click target text/element → Inspect.
3. Copy a stable class or selector (for example .announcement-bar__message).
4. Use that selector in GeoTailor rule actions.

What to avoid

• Random auto-generated class names that change on deploy.
• Very deep selectors tied to current DOM nesting.
• Selectors that match multiple unrelated elements.

9. Developer Hooks

Listen to GeoTailor readiness after rule payload evaluation:

document.addEventListener("geotailor:ready", (e) => {
  console.log(e.detail.countryCode, e.detail.rules, e.detail.popups);
});

Payload fields: countryCode, rules, popups.