How to Enable URL Rewriting in Joomla
Joomla's Use URL Rewriting option removes index.php from SEF URLs by relying on the web server to route clean requests back to Joomla. Enable it only after SEF URLs already work and the correct rewrite configuration is active on the server.
Confirm SEF routing works first
- Go to System → Global Configuration → Site.
- Enable Search Engine Friendly URLs.
- Keep Use URL Rewriting disabled temporarily.
- Save and test several frontend routes.
If readable URLs with index.php work, Joomla routing is healthy and you can isolate any later problem to the rewrite layer.
Prepare the web server
For Apache-compatible hosting, Joomla supplies htaccess.txt in the Joomla root. Review any existing .htaccess first, back it up, and activate or merge Joomla's rules as appropriate. The server must allow the required rewrite directives.
Nginx does not process .htaccess; its server configuration needs an equivalent front-controller rule. Microsoft IIS uses its own rewrite configuration. Confirm the actual server before applying Apache instructions.
Enable Use URL Rewriting
- Return to System → Global Configuration → Site.
- In SEO settings, set Use URL Rewriting to Yes.
- Save the configuration.
- Open the frontend in a private/incognito window.
- Test the home page and several deep routes.
Working public URLs should no longer require index.php.
Handle subdirectory installations carefully
If Joomla is installed under a path such as /site/, the server may need base-path adjustments. On Apache, review the comments around RewriteBase in Joomla's supplied file. Do not uncomment or copy a value blindly; it must match the actual deployment.
Troubleshoot immediately if pages fail
- 404 after removing index.php: verify the rewrite rules are active, the document root is correct, and subdirectory routing is correct.
- 500 after activating .htaccess: inspect the server error log for an unsupported or disallowed directive.
- Redirect loop: review HTTP/HTTPS, www/non-www, proxy, CDN, and canonical redirects together.
Disable Use URL Rewriting while repairing the server configuration so the site remains reachable.
Verify more than the home page
Test menu routes, articles, forms, multilingual pages, component routes, and direct deep links. Clear Joomla and edge caches and check logs for unexpected 404 or 500 responses. A successful home page alone does not prove rewriting is correct.
Need More Help with Joomla?
Still having trouble? Open a support ticket with QuantaCade Support and we'll be happy to help where we can.
Support priority is given to QuantaCade products, services, and customers. However, we're also happy to assist fellow Joomla users with general Joomla questions and troubleshooting when possible.
QuantaCade is an independent Joomla extension developer and is not official Joomla support. Some issues involving third-party extensions, hosting environments, server configurations, or other systems outside our development control may be beyond what we're able to resolve.