Storefront
Navigate to yStore → Store → Storefront.
The Storefront settings page controls how yStore connects to and configures the customer-facing frontend — default search behaviour, age verification gates, cross-border trade toggles, and the list of countries your store ships to.
Settings
| Setting | Description |
|---|---|
| Store URL | The public-facing URL of the storefront (used in email links, cart recovery URLs, etc.) |
| Default search engine | Which search provider powers catalog search (native or Algolia if the plugin is installed) |
| Search results limit | Default number of products shown per search results page |
| Age verification | Enable a gate that requires customers to confirm their age before accessing the store |
| Minimum age | The minimum age (years) required to pass the gate |
| Cross-border trade | Whether customers from outside your primary country can purchase |
| Allowed countries | Restricted list of countries from which orders are accepted (leave empty for all countries) |
Age verification
When age verification is enabled, customers see a confirmation modal on first visit. Unconfirmed visitors cannot browse the catalog or check out.
Age verification acceptance is stored in the session and cookie. Clearing cookies resets it. This is a basic access gate — it is not a legal identity verification system. For regulated products, consult legal counsel on your obligations.
Cross-border trade and allowed countries
Cross-border trade must be enabled before customers from other countries can purchase. When enabled, you can also specify an allowed countries list:
- Empty list — all countries are allowed (default)
- Populated list — only listed countries can complete checkout
Customers from disallowed countries see an error at checkout before entering any payment information.
The allowed countries list controls checkout access. Shipping zones (configured in yStore → Shipping) control which shipping methods are available per destination. Use both together — the allowed countries list as a hard gate, and shipping zones to route eligible countries to the right carriers.
Per-store-view overrides
Storefront settings can be scoped to a specific store view. Select a store view from the Store View dropdown at the top of the page before saving. Settings saved with a store view selected only apply to that view — the global settings remain unchanged.
This is useful for:
- Different allowed countries per regional storefront
- Different age verification rules per market
- Different search defaults per view