Region Management

Frontier Quote uses a whitelist/blacklist system to control which countries see quote buttons instead of checkout.

Understanding Whitelist and Blacklist

Whitelist Countries

Countries in the whitelist will always see checkout buttons, regardless of shipping profile configuration. This ensures standard checkout is always available for these countries.

Use case: Your primary markets where you always want standard checkout available.

Blacklist Countries

Countries in the blacklist will always see quote buttons, even if they have shipping profiles configured. This forces quote collection for these countries.

Use case: International markets where you need custom pricing or want to review orders before processing.

Priority

If a country appears in both whitelist and blacklist, the whitelist takes precedence (checkout button will be shown).

Setting Up Regions

Step 1: Access Region Settings

  1. Open Frontier Quote app
  2. Go to Settings page
  3. Find the Region Configuration section

Step 2: Add Countries to Whitelist

Region Configuration: Screenshot of country selector interface
  1. Click "Add Countries" in the Whitelist section
  2. Use the country selector (Polaris component matching Shopify shipping settings)
  3. Select countries that should always see checkout
  4. Click "Save"

Step 3: Add Countries to Blacklist

  1. Click "Add Countries" in the Blacklist section
  2. Select countries that should always see quote buttons
  3. Click "Save"

Country Codes

Frontier Quote uses ISO country codes (e.g., US, CA, GB, FR, DE). The country selector ensures you're using valid codes that match Shopify's country system.

Region Detection

Frontier Quote detects visitor countries using:

  1. Primary: Shopify's /browsing_context_suggestions.json endpoint
  2. Fallback: ipapi.co free IP geolocation API
  3. Cache: Results are cached in localStorage for 24 hours

Testing Regions

You can test how your storefront looks from different countries using:

  1. The built-in Testing page in the app (country simulation tool)
  2. URL parameter: ?fq_country=XX (replace XX with country code)

Example: https://yourstore.com/cart?fq_country=FR will simulate viewing from France.

Future Enhancements

Planned feature: Automatic detection based on Shopify shipping profiles. Countries without shipping profiles will automatically show quote buttons, working in conjunction with whitelist/blacklist.

Best Practices

  • Start with a small blacklist to test the flow
  • Use whitelist for your primary markets to ensure checkout is always available
  • Test from different countries using the testing tools
  • Monitor analytics to see which countries are requesting quotes

Next Steps