Adding your regional storefronts to StoreViewer
Last updated: June 2026
In this article
Overview
Your regional storefronts are the foundation of everything in StoreViewer. Once added, StoreViewer remembers them and loads them automatically on every launch. You only need to set this up once — or any time your store URLs change.
How StoreViewer uses your URLs
Each region needs a base URL — the root address of that storefront, with no page path attached. When you type a path into the URL bar (e.g. /products/shoes), StoreViewer appends it to every base URL and loads them all at once.
StoreViewer supports both common URL structures used by multi-region stores:
TLD-based — each region lives on its own domain or country-code domain:
https://www.yourbrand.com
https://www.yourbrand.com.au
https://www.yourbrand.co.nz
Subfolder-based — regions are separated by path prefix on a single domain:
https://www.yourbrand.com/us
https://www.yourbrand.com/au
https://www.yourbrand.com/eu
Both work the same way in StoreViewer. You can also mix them if your setup uses different structures across regions.
Adding regions
- Click the Settings icon in the toolbar to open the configuration modal
- Go to the Regions tab
- Click Add region
- Enter a short display name for the region — this appears in the pane toolbar (e.g.
AU,US,NZ,EU) - Enter the base URL for that region
- Repeat for each region you want to add
- Click Save
There's no limit on the number of regions you can add.
Tips for getting your base URLs right
Don't include a trailing slash. Use https://www.yourbrand.com.au, not https://www.yourbrand.com.au/. A trailing slash can cause double-slash issues when StoreViewer appends a path.
Don't include a page path. The base URL should point to the storefront root only. The path you type into the URL bar gets added on top of it — so if your base URL already includes /products, every path you enter will be nested under that.
Include the protocol. Always start with https:// (or http:// if the site doesn't have SSL, though this is uncommon for live stores).
Test with your homepage first. After saving, leave the URL bar empty and press Enter — StoreViewer will load the homepage of each region. If any pane shows an error or the wrong page, double-check that region's base URL.
Editing or removing a region
Open Settings → Regions at any time to rename a region, update its URL, reorder regions, or remove one entirely. Changes take effect immediately — StoreViewer reloads the affected panes on save.
To reorder regions without opening Settings, you can drag the region chips in the toolbar directly. The order you set here is the order panes appear in the layout, and it persists between sessions.
Using multiple sets of regions
If you need to switch between different sets of storefronts — for example, your own brand's stores and a competitor's sites — use saved profiles rather than manually editing your regions each time. A profile saves your complete setup (regions, URLs, layout, and current path) under a name you choose, and you can switch between profiles in one click from the toolbar.
See Using saved profiles to switch between your stores and competitor sites for how to set this up.
Need help? Email sales [at] storeviewer.app