• Setting up your external DNS provider to point your custom domain to your VTEX website. Custom domains can be purchased from any domain registration platform.
• Configuring your custom domains in VTEX Account Settings.
• Associating your custom domains with your FastStore project.

• Develop your FastStore project by following the Getting Started track.
• Deploy your FastStore project.
• Buy the desired domain.
• Redirect the root domain to the www subdomain.

If you still need to configure other VTEX solutions, please use a fictitious domain name while taking the following steps. Once you have set up all the desired integrations, repeat this guide using your final domain to make your website publicly available to end users.

1. Access your domain provider's website.
2. Create a CNAME DNS record for your www domain (example: www.mystore.com) that points to www.{rootDomain}.cdn.vtex.com (example: www.mystore.com.cdn.vtex.com). Check your domain provider's documentation for more information.
3. Now, create a CNAME record for the secure subdomain (example: secure.mystore.com) that points to secure.{rootDomain}.cdn.vtex.com (example: secure.mystore.com.cdn.vtex.com). The Checkout, Order Placed, Login, and My Account pages will use this subdomain.

The configured addresses may not be immediately available to everyone due to DNS propagation, which can take 24-48 hours to complete.

For more information about store domain configuration, see the Configuring the store domain guide.

1. On VTEX Admin, click your profile avatar, which can be identified by the first letter of your email address.
2. Access Account Settings > Account.
3. Go to the Stores tab and in the Hosts table, click the menu (⋮) and choose Edit.
4. In the Hosts field, enter your main domain (example: www.mystore.com) to the list.
5. Click Add.
6. Add the secure subdomain (example: secure.mystore.com) to the list.

   
7. Add the root domain as well; for example, if your domain is www.mystore.com, add mystore.com. For a complete setup, you must add three hosts for each domain:
   • www.mystore.com (store domain)
   • mystore.com (root domain)
   • secure.mystore.com (checkout/myaccount subdomain)

To ensure a seamless checkout experience, all subdomains used by your store must be added to the host list. For more information, see the Adding subdomains to the host list section.

8. Click the Save button.

1. Open your FastStore project in any code editor of your preference.
2. Open the discovery.config.js file.
3. Update the storeUrl, secureSubdomain, checkoutUrl, loginUrl, and accountUrl properties as in the following, replacing the values between curly brackets according to your scenario:
   • storeUrl: https://{subdomain}.{rootDomain}
   • secureSubdomain: https://{subdomain}.{rootDomain}
   • checkoutUrl: https://{subdomain}.{rootDomain}/checkout
   • loginUrl: https://{subdomain}.{rootDomain}/api/io/login
   • accountUrl: https://{subdomain}.{rootDomain}/api/io/account

4. Save your changes.
5. Open the vtex.env file.
6. Add the SITE_HOST key with the main domain specified in Configuring domains in VTEX Account Settings as the value.
   /vtex.env

   
   

   _10

   + SITE_HOST=www.mystore.com

   
   
7. Save your changes.
8. Open a Pull Request, commit your changes, and deploy them to main.

For stores with prefixed domains, add the subDomainPrefix property to discovery.config.js to ensure product visibility in the secured environment. For more information, see the Adding subDomainPrefix for prefixed domains section.

• Your VTEX account name.
• The secure and main domains of your store.

WebOps domain configuration always takes priority over any settings in discovery.config.js. It’s recommended that you manage all domain configurations through WebOps to centralize all domain settings into a single source.

1. Access your FastStore WebOps Dashboard.
2. Navigate to the Settings tab.
3. In the Host field, choose your store’s domain (example: www.mystore.com) from the dropdown list.
4. Click Add.
   

If the domain setting is incorrect, the deployment will receive the status Failed. Learn more about statuses and how to visualize deployment details in Production deploys.

1. Access your WebOps dashboard.
2. Navigate to the Settings tab.
3. Confirm your domain appears in the Current Domains list.
   

1. Open a ticket to VTEX support requesting a domain migration for your FastStore WebOps implementation. Please include the following information:
   • VTEX account name
   • Store’s domain (example: www.mystore.com)
   • Secure domain (example: secure.mystore.com)
   • Confirmation that you’ve completed all previous steps in this guide.
2. Wait for the VTEX team to process your request and complete the domain migration.
3. Once the migration is complete, test your store to ensure everything is working properly. If you encounter any issues, inform us through the same ticket you used to request the migration of your domain.

• Stores with multiple subdomains: Add all the subdomains to the host list.
• Stores with prefixed domains: Add subDomainPrefix for prefixed domains.

1. Open your FastStore project in a code editor of your preference.
2. Open the discovery.config.js file.
3. Navigate to the api object and add the following:
   
   

   _10

   // Platform specific configs for API

   _10

   api: {

   _10

   ...

   _10

   subDomainPrefix: ['xxx']

   _10

   },

   
   

   Replace 'xxx' from subDomainPrefix property with the actual subdomain prefix (example: ['b2b']). If you have multiple prefixes, add them as an array of strings (example: ['b2b', 'dev']).

4. Save your changes.
5. Open a Pull Request, commit your changes, and deploy them to main.

• Configuring the store domain
• Setting up DNS pointing to VTEX
• Insert a reverse proxy in front of VTEX services