Configure a Hostname Alias

A hostname alias is required if you want to create short, meaningful URLs for external search engines to index. Assign at least one hostname alias that is the current hostname on which the instance is running.

You can also create a simpler alias that reflects your store or brand name. Putting a simple Page URL in the alias list, such as "", enables users to get to the storefront without typing in the full Salesforce B2C Commerce URL, such as:

Ideally, the long URL is only visible to search engines if someone posts a link containing the long URL.

Important: If you don't assign an alias to your site, enabling search-friendly URLs causes the storefront to show a 404 error for all URLs besides the Welcome page.
  1. Select site > Site URLs > Aliases.
  2. On the Aliases page, create a set of hostname alias rules.
  3. If you want to test that your rules are valid JSON, we recommend that you test them against a debugging tool. Remember to remove any comments from your mapping files and use colons (:) instead of equal signs (=) to separate property and value.
    Site URL aliases files are instance-specific, so site URL aliases are individually managed for each instance (Development, Staging, and Production). Because each instance has its own aliases file, these files are not included in data replication. This ensures that a data replication of Site URL Management doesn't overwrite URL alias settings on Production with the Staging configuration.
    Individually edit the site URL aliases on each instance (Development, Staging, Production) to have the same aliases on all instances.
  4. When you are satisfied that your alias file is valid, copy it into the editor and click Apply.
X Privacy Update: We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used. By continuing to use this site you are giving us your consent to do this. Privacy Policy.