Shopify App Setup
Install GeoSwap from the Shopify App Store — no code editing required
Overview
The GeoSwap Shopify app lets you add geo-targeting to your store without touching any code. Install from the App Store, connect your GeoSwap workspace, enable the theme block, and your geo rules start working immediately.
Already using GeoSwap with a manual script tag? The Shopify app replaces the manual theme.liquid installation described in the Installation Guide. You can use either method, but the app is simpler and doesn't require code access.
How It Works
The Shopify app is a lightweight connector between your store and GeoSwap. Here's what happens under the hood:
Theme App Extension
The app adds a theme block that loads geoswap.js on your storefront. You enable it in the theme editor — no files are modified directly.
Automatic Configuration
When you connect a workspace, the app writes your project ID to a shop metafield. The theme block reads it automatically — no copy-pasting IDs. If you switch workspaces, the metafield updates and the change takes effect on the next page load.
SEO Safety
All geo rules are evaluated server-side by GeoSwap's edge network. Search engine crawlers always see your original content — no cloaking, no SEO risk. This works identically to the manual installation.
Setup Guide
Install from the Shopify App Store
Search for "GeoSwap" in the Shopify App Store, or use the direct link from geoswap.co. Click Install and approve the permissions.
The app only requests read_themes permission — it reads your theme to check if the GeoSwap block is enabled. It never writes to your theme or accesses customer data.
Connect your GeoSwap workspace
After installing, open the GeoSwap app from your Shopify Admin sidebar. You'll see a "Connect GeoSwap Workspace" button.
- Click Connect GeoSwap Workspace — this opens GeoSwap in a new tab.
- Sign in or create a free GeoSwap account.
- Choose the workspace you want to connect to your store (or create a new one).
- Go back to the Shopify app tab and click Refresh status.
Your store is now linked. Any geo rules you create in that workspace will apply to your Shopify store.
Enable the GeoSwap theme block
The app installs a theme block, but you need to enable it in your theme editor:
- Go to Online Store → Themes in your Shopify Admin.
- Click Customize on your active theme.
- In the theme editor, look for App blocks (usually under the header or in the sidebar).
- Add the "GeoSwap Geo Targeting" block.
- Click Save.
Theme block won't auto-enable
Shopify requires merchants to manually enable app blocks in the theme editor. The app cannot inject scripts automatically. If the block isn't enabled, geo rules won't apply to your storefront.
Create your first geo rule
Click Manage Geo Rules in the GeoSwap app to open your workspace dashboard. From there you can:
Geo Redirects: Send visitors from France to your .fr store, visitors from Germany to your .de store, etc.
Geo Content: Show different pricing, banners, or CTAs based on visitor location.
Geo Links: Create short links that route to different URLs by country.
Testing Your Setup
Use the built-in Rule Simulator in your GeoSwap dashboard to test geo rules without being in another country. The simulator lets you pick any country, state, or city and see exactly which rules would fire for that visitor.
Open your GeoSwap dashboard and go to Tools → Simulate.
Enter your store URL and select a country to simulate.
The simulator shows which redirect, content swap, or popup would apply for a visitor from that location.
Managing Your Connection
Switching workspaces
Click "Link to different workspace" in the GeoSwap app. This opens the workspace picker where you can connect a different workspace. The change takes effect immediately — no need to edit your theme.
Disconnecting
Click "Disconnect" in the GeoSwap app. This removes the workspace link but keeps the app installed. The theme block stays in your theme but stops applying geo rules. You can reconnect a workspace at any time.
Uninstalling
Uninstall the app from Settings → Apps and sales channels in your Shopify Admin. This removes the workspace link and revokes the access token. If you reinstall later, you'll need to reconnect your workspace.
Frequently Asked Questions
Does the app slow down my store?
No. The GeoSwap script is under 5KB gzipped, loaded with the `defer` attribute, and served from a global CDN. It doesn't block page rendering.
Will this affect my store's SEO?
No. All geo decisions are made server-side. Search engine crawlers (Google, Bing, etc.) always see your original content. GeoSwap never cloaks or hides content from bots.
Can I use this alongside Shopify Markets?
Yes. GeoSwap works independently from Shopify Markets. You can use both — for example, Shopify Markets for currency/language and GeoSwap for geo redirects to entirely different domains.
What data does the app access?
The app only has `read_themes` permission. It cannot access your orders, customers, products, or any other store data. It reads your theme solely to check if the GeoSwap block is enabled.
What happens if I switch themes?
You'll need to re-enable the GeoSwap block in your new theme. The workspace connection stays intact — only the theme block needs to be re-added.
Next up
Learn how to create geo redirect rules.