After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Configuring URL Rewrites

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

URL rewrites make it possible to make existing URLs more search engine friendly and also easier for humans to read. Enabling Web Server Apache Rewrites is part of the initial Magento setup. Magento routinely uses URL rewrites to remove the file name index.php that normally appears in the URL just after the root folder. When Web Server Rewrites are enabled, the system rewrites each URL to omit index.php. The rewrite removes words that convey nothing of value to search engines or customers, and has no impact on performance or site rank.

URL without Web Server Rewrite

https://www.yourdomain.com/magento/index.php/storeview/url-identifier

URL with Web Server Rewrite

https://www.yourdomain.com/magento/storeview/url-identifier

Configure URL Rewrites

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel where General is expanded, choose Web.

  3. Expand Expansion selector the Search Engine Optimization section.

    General configuration - web search engine optimization Search Engine Optimization

  4. Set Use Web Server Rewrites to your preference.

  5. When complete, click Save Config.