FastStore now routes Checkout and My Account pages through the store's primary domain (e.g., www.domain.com), removing the need for a separate secure.domain.com subdomain. This reduces configuration steps and avoids cross-domain redirects.
What has changed?
Previously, FastStore required a distinct secure domain for Checkout and My Account pages. Now, FastStore operates with a single domain by default. This means all store URLs, including those for secure operations, will use the same base domain. Below is a comparison of the configuration in the discovery.config.js file:
-
Before: Stores required a separate
secure.domain.comsubdomain for secure pages._10storeUrl: "https://www.domain.com",_10secureSubdomain: "https://secure.domain.com",_10checkoutUrl: "https://secure.domain.com/checkout",_10loginUrl: "https://secure.domain.com/api/io/login",_10accountUrl: "https://secure.domain.com/api/io/account", -
After: All URLs (store, checkout, login, and account) use the same domain.
_10storeUrl: "https://www.domain.com",_10secureSubdomain: "https://www.domain.com",_10checkoutUrl: "https://www.domain.com/checkout",_10loginUrl: "https://www.domain.com/api/io/login",_10accountUrl: "https://www.domain.com/api/io/account",
Why did we make this change?
Using a single domain simplifies FastStore configuration and reduces the complexity of managing multiple secure DNS entries. It also improves the customer experience by preventing redirects between different domains.
What needs to be done?
To enable the single-domain feature, request the account configuration from VTEX. This ensures proper routing and security settings for your store.
-
Open a ticket with VTEX Support requesting the account be configured for a single-domain setup. Please include the following information in the ticket:
-
Account name
-
FastStore version
Stores that enabled the single-domain setup before June 26, 2025 should open a new support ticket to receive the most up-to-date version of this functionality.
-
-
After receiving confirmation that the single-domain setup is configured:
- Update the
Production URLssection in thediscovery.config.jsfile to ensure all URLs are consistent. For more information, see Step 4 - Associating your custom domain with your FastStore project. - Configure your production domain in the Settings tab of the FastStore WebOps Dashboard. For more information, see Step 6 - Adding your store domain to FastStore WebOps.
- Update the
Verifying the single-domain configuration for /checkout
To confirm that your store is using single-domain routing for Checkout, open an incognito/private browsing window and navigate to your store’s domain (for example, https://www.yourstore.com/checkout).
The VTEX Checkout should load under the same main domain, without redirecting to any secure subdomain. You can also test by adding a product to the cart and proceeding to checkout, ensuring that the URL remains on your main domain throughout the process. If /checkout fails to load correctly or you are redirected to a different domain, open a ticket with VTEX Support. In the ticket, indicate that you are enabling the single-domain configuration for Checkout and include your VTEX account name.