Domain-related settings are necessary for a web address to be correctly routed to a VTEX store. This guide covers the following topics:

• Store address structure
• Rules for main hosts
• How to register a new host
• How to change the host from an active store

The store's address is composed of the following elements:

Once you have defined your store's domain, you need to configure the main host in the VTEX Admin to communicate between the address and the store's content.

Before proceeding with your store's address configuration, consider the following guidelines to ensure a successful implementation:

• CDN providers: VTEX uses two CDN providers for the stores: Cloudfront and Azion. Make sure that your store's domain is not registered with these services during the pointing process. Otherwise, the CDN provisioning for your store and, consequently, the go-live will fail. Therefore, if your store's domain is registered on the Cloudfront or Azion platform, remove this registration before pointing the DNS to VTEX.
• Main address: The store must have a single main host, which will point to the VTEX servers. This host must contain a subdomain, which can be www or others.
• Additional addresses: Any additional addresses, whether with a different domain or a version without subdomains, must be redirected to the single main host, as described in the Redirects section.

Check out the host examples below and see which ones can be used as the main host:

To ensure your store is accessible via different URLs, such as www.mystore.com and mystore.com, you should register a single main host and redirect the additional addresses to the main one. Learn more about redirects:

• Redirection from other addresses
• Best practices for accessing the store without www

We recommend implementing a single host in your store.

To register a new host, they must comply with the guidelines specified in the Rules for main hosts section. Follow the instructions below:

1. In the top bar of the VTEX Admin, click your profile avatar, indicated by the initial letter of your email address.
2. Click the Account settings button.
3. Click Account.
4. Click the Store tab.
5. Click the actions button corresponding to the store where you want to register the host and click Edit.
6. Enter the host in the Hosts field. For example: www.mystore.com.
7. Click Add.
8. Click Save.

After completing these steps, you can configure DNS pointing to VTEX.

FastStore stores also need to configure an address with the secure subdomain. Refer to the Configuring external DNS for a custom domain guide for more details.

If your operation has more than one VTEX account or sub-account, don't change hosts from one account to another. This will cause failures in many aspects of your store.

The VTEX platform is designed to support host changes without adverse impacts. If you need to change your store's host, follow the steps below:

1. Create new host entries for the store you want by following the instructions in Registering a new host. At this stage, the DNS of the new domain must not yet be pointed to VTEX.

2. In the VTEX Admin, check the Checkout settings in Store Settings > Storefront > Checkout, as described in the Configure template in SmartCheckout article. Completing this step is crucial to ensure the Checkout will continue working after the change.

   You need to check if the sites configured are associated with the account registered in Account settings > Accounts. See the Account management article for more details.

3. Point the new domain's DNS to VTEX. Learn more about DNS pointing.

4. If your store uses VTEX IO - Store Framework or FastStore, contact VTEX support and submit a request for internal pointing, specifying the new domain. Once the ticket has been opened, the support team has up to three business days to analyze the settings and complete the pointing process.

5. After confirming the new host's DNS propagation and internal pointing, delete the old hosts and keep only the new one.