Catalog and product URLs
The URLs you assign to products and categories play a major role in determining how well your site is indexed by search engines. Before you start building your catalog, consider the available options. To view the current URL format, go to the storefront and navigate to any product in your catalog. The format of the URL depends on the current configuration settings and method that you use to find the page.
URL formats
Dynamic URL
A dynamic URL is created on the fly and might include a query string with variables for the product ID, sort order, and the page where the request was made. When a customer searches for a product in your store, the resulting URL might look something like this:
http://mystore.com/catalogsearch/result/?q=racer+back
http://mystore.com/women/tops-women.html?style_general=135
Static URL
A static URL is a fixed address for a specific page. A static URL can be displayed in a search engine-friendly format or one that references products and categories by ID. These URLs include words that people might use to look for a product, and require web server rewrites to be enabled. Files with static URLs are commonly used for product and category pages, content pages, and theme assets.
http://mystore.com/antonia-racer-tank.html
URL components
URL key
The URL key is the part of a static URL that describes the product or category. When you create a product or category, an initial URL key is automatically generated, based on the name. To change the URL key, see the Search Engine Optimization section of the product information.
ñ
is automatically replaced by n
. This behavior can be disabled by setting the Search Engine Optimization: Apply transliteration for product URL configuration option to No
. See Configure catalog URLs.The URL key should consist of lowercase characters with non-trailing hyphens between these characters to separate words. Hyphens are not allowed at the start or at the end of the URL key. A well-designed, “search engine friendly” URL key might include the product name and key words to improve the way it is indexed by search engines. The URL key can be configured to create an automatic redirect if the URL key changes.
HTML suffix
Your catalog can be configured to either include or exclude the suffix as part of category and product URLs. There are various reasons why people might choose to use or to omit the suffix. Some believe that the suffix no longer serves any useful purpose, and that pages without a suffix are indexed more effectively by search engines. However, your company might have a standardized format for URLs that requires a suffix.
Because the suffix is controlled by the system configuration, you should never type it directly into the URL key of a category or product. (Doing so results in a double suffix at the end of the URL.) Whether you decide to use the suffix or not, be consistent and use the same setting for all your product and category pages. Here are examples of URLs with—and without—a suffix.
URL with HTML suffix
http://mystore.com/helena-hooded-fleece.html
http://mystore.com/helena-hooded-fleece.htm
URL without HTML suffix
http://mystore.com/helena-hooded-fleece
Category path
You can configure the URL to either include or exclude the category path. By default, the category path is included in all category and product pages. The following examples show the same product URL with, and without, the category path.
URL with category path
http://mystore.com/women/tops-women/hoodies-and-sweatshirts-women/helena-hooded-fleece.html
URL without category path
http://mystore.com/helena-hooded-fleece.html
To prevent search engines from indexing multiple URLs that lead to the same content, you can exclude the category path from the URL. Another method is to use a canonical meta tag to let search engines know which URLs to index and which to ignore. By default, Commerce does not include the category path in product URLs.
Configure catalog URLs
-
On the Admin sidebar, go to Stores > Settings > Configuration.
-
In the left panel, expand Catalog and choose Catalog underneath.
-
Expand the Search Engine Optimizations section and set the options:
-
Set Product URL Suffix to
html
orhtm
. Enter the suffix without a period, because it is applied automatically. -
Set Category URL Suffix to
html
orhtm
. Enter the suffix without a period, because it is applied automatically. -
Set Use Categories Path for Product URLs to your preference.
{width="600" modal="regular"}
For a detailed list of these options, see Search Engine Optimization in the Configuration Reference.
-
-
When complete, click Save Config.
-
When prompted, click the Cache Management link in the system message and refresh the invalid cache.
{width="450" modal="regular"}
For more information about these options, see Refresh caches.
Configure catalog media URL format
-
On the Admin sidebar, go to Stores > Settings > Configuration.
-
In the left panel, expand General and choose Web.
-
Expand the Url Options section and set the options:
{width="600" modal="regular"}
Yes
/ No
No
/ Yes (302 Found)
/ Yes (301 Moved Permanently)
Important! Do not use auto-redirect to base URL for multi-store setups.
Unique hash per image variant (Legacy mode) - Defines converted filename as a unique hash value.
Image optimization based on query parameters - Defines image optimization process depending on query parameters.