Troubleshooting

This guide covers common issues and solutions for Frontier Quote.

Quote Button Not Appearing

Check Theme App Extension

  1. Go to Online Store > Themes
  2. Click Customize on your active theme
  3. Check App embeds section
  4. Ensure "Frontier Quote" is toggled on
  5. Click Save

Verify Theme Compatibility

Frontier Quote requires Online Store 2.0 themes. Check your theme version in theme settings.

Clear Cache

  • Clear browser cache
  • Clear localStorage (country detection is cached for 24h)
  • Hard refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)

Check Browser Console

Open browser developer tools (F12) and check for JavaScript errors. Common issues:

  • Script conflicts with other apps
  • Theme JavaScript errors
  • Network errors loading app assets

Wrong Button Showing

Check Region Configuration

  1. Verify country is in correct list (whitelist vs blacklist)
  2. Remember: whitelist takes precedence over blacklist
  3. Use testing tool to simulate country

Check URL Parameter

If testing with ?fq_country=XX, ensure country code is correct (e.g., US, CA, GB, FR).

Form Not Submitting

Check Required Fields

Ensure all required fields are filled:

  • First name
  • Last name
  • Email (valid format)
  • Full shipping address

Check Network Tab

Open browser developer tools > Network tab and look for failed requests to /apps/frontier-quote/quote.

Verify App Proxy

Ensure the app proxy is configured correctly in Shopify app settings. The endpoint should be /apps/frontier-quote/quote.

Draft Order Not Created

Check App Permissions

  1. Go to Settings > Apps and sales channels
  2. Find Frontier Quote
  3. Click Manage
  4. Verify "Write Draft Orders" permission is granted

Check Draft Orders

  1. Go to Orders > Drafts in Shopify admin
  2. Look for Draft Orders with your configured tag (default: gq-quote)
  3. Check if Draft Order was created but in different section

Check App Logs

If you have access to app logs, check for errors during Draft Order creation. Common issues:

  • Invalid variant IDs
  • Missing customer information
  • API rate limits

Notifications Not Working

Check Flow Template

  1. Verify Shopify Flow workflow is activated
  2. Check trigger condition matches Draft Order tag
  3. Verify tag in Flow matches tag in Frontier Quote settings

Test Flow Manually

  1. Create a manual Draft Order in Shopify
  2. Add the tag (e.g., gq-quote)
  3. Verify Flow triggers

Country Detection Issues

Wrong Country Detected

  • IP geolocation is not 100% accurate
  • VPN users may show incorrect country
  • Use URL parameter ?fq_country=XX for testing

Country Detection Failing

  • Check browser console for API errors
  • Verify Shopify /browsing_context_suggestions.json is accessible
  • Check if ipapi.co fallback is working
  • Clear localStorage cache

Performance Issues

Slow Page Load

  • Check if other apps are conflicting
  • Verify Theme App Extension assets are loading
  • Check network tab for slow requests

Button Replacement Delay

Button replacement happens after page load and country detection. This is intentional to avoid blocking checkout. If delay is excessive:

  • Check country detection API response time
  • Verify localStorage cache is working

Getting Help

If you've tried these solutions and still have issues:

  • Check the documentation for more details
  • Contact support via the contact page
  • Leave a review on the Shopify App Store with your question

Common Error Messages

"Quote submission failed"

  • Check internet connection
  • Verify app is installed and active
  • Check browser console for detailed error

"Invalid cart"

  • Ensure cart has items
  • Try refreshing cart page
  • Clear cart and add items again

"Country not configured"

  • Check region settings in app
  • Verify country code is valid
  • Ensure whitelist/blacklist is set up