Documentation
Feedback
Guides

Release Notes
Release Notes
Improved
FastStore: Simplified domain configuration
2 days ago

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.com subdomain for secure pages.


    _10
    storeUrl: "https://www.domain.com",
    _10
    secureSubdomain: "https://secure.domain.com",
    _10
    checkoutUrl: "https://secure.domain.com/checkout",
    _10
    loginUrl: "https://secure.domain.com/api/io/login",
    _10
    accountUrl: "https://secure.domain.com/api/io/account",

  • After: All URLs (store, checkout, login, and account) use the same domain.


    _10
    storeUrl: "https://www.domain.com",
    _10
    secureSubdomain: "https://www.domain.com",
    _10
    checkoutUrl: "https://www.domain.com/checkout",
    _10
    loginUrl: "https://www.domain.com/api/io/login",
    _10
    accountUrl: "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.

  1. 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.

  2. After receiving confirmation that the single-domain setup is configured:

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.

Was this helpful?
Yes
No
On this page