How to Enable SEF URLs in Joomla (and Remove index.php Safely)

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

Antihost offers Linux VPS plans with full root access, unlimited traffic on a 1 Gbps port and a 14-day free trial.

In Joomla Administrator, open System → Global Configuration → Site, find the SEO section, set Search Engine Friendly URLs to Yes, and save. That enables readable Joomla routes. Removing index.php is a separate server-rewrite step: Apache requires a correctly named .htaccess file and permitted overrides, while Nginx needs a try_files rule pointing requests to Joomla’s index.php.

What SEF URLs mean in Joomla

Search engine friendly (SEF) URLs are human-readable paths that describe the page they lead to. Instead of exposing a query-heavy address, Joomla can build a route from the site’s menu and content structure. A typical SEF path is easier for a visitor to read and recognize before opening it.

#	Preview	Product	Price
1		Using Joomla!: Efficiently Build and Manage Custom Websites	$22.79	Buy on Amazon
2		Official Joomla! Book, The (Joomla! Press)	$31.81	Buy on Amazon
3		Joomla! For Dummies	$13.61	Buy on Amazon
4		Official Joomla! Book (Joomla! Press)	$23.89	Buy on Amazon
5		Joomla! 4 Masterclass: A practitioner's guide to building rich and modern websites using the...	$38.99	Buy on Amazon

Joomla has two related but separate controls:

• Search Engine Friendly URLs changes Joomla’s generated links to readable routes.
• Use URL Rewriting (previously labeled Use Apache mod_rewrite/URL rewriting) removes index.php from the visible path when the web server is configured to pass requests through Joomla.

You can use SEF URLs while leaving index.php in the address. URL rewriting is an additional layer, not a prerequisite for the first setting.

Check these prerequisites first

• Administrator access: You must be able to open Global Configuration and save site settings.
• Know the web server: Establish whether the site runs on Apache, Nginx, or another server. If you cannot identify it, ask your hosting provider before changing rewrite settings.
• Access to the Joomla root (Apache): Renaming htaccess.txt requires access to the directory containing Joomla’s files.
• Virtual-host access (Nginx): The try_files directive belongs in the Nginx server configuration, which is usually controlled by the host rather than Joomla Administrator.
• A safe test point: If possible, test on a staging copy or during a maintenance window. Keep a way to return to the previous configuration if a rewrite change causes errors.

SEF is a routing change, so test more than the home page. Plan to open several menu items and articles after each save.

#1 Best Overall

Sale

Using Joomla!: Efficiently Build and Manage Custom Websites

$22.79

Buy on Amazon

Enable Search Engine Friendly URLs

1. Sign in to Joomla Administrator.
2. Open System.
3. Under Setup, select Global Configuration.
4. Choose the Site tab.
5. Scroll to the SEO section.
6. Set Search Engine Friendly URLs to Yes.
7. Click Save or Save & Close.

At this point Joomla should generate readable routes from the site’s content and menu structure. Open several menu links and at least a few article pages in a new browser tab. This confirms that the setting was saved and that the routes being generated by the site resolve correctly.

If the addresses are readable but still contain index.php, that is expected until the separate URL-rewriting configuration is completed.

Remove index.php with Apache

1. Rename Joomla’s distributed rewrite file

In the Joomla installation root, rename htaccess.txt to .htaccess. The leading dot is part of the filename; do not leave the file as htaccess.txt or create a second extension.

This file supplies the per-directory rules Joomla needs when Apache handles URL rewriting. Renaming it alone does not guarantee that Apache will apply the rules: the server must also permit overrides for that directory.

Rank #2

Sale

Official Joomla! Book, The (Joomla! Press)

$31.81

Buy on Amazon

2. Confirm that Apache permits overrides

Apache must allow the Joomla directory to use its .htaccess directives. The relevant virtual-host or directory configuration needs an AllowOverride setting that permits those overrides. If the host controls Apache configuration, ask the provider to confirm that overrides are enabled for the Joomla document root.

Also confirm that Apache’s rewrite module is available. Joomla’s older administrator wording refers specifically to Apache mod_rewrite; the newer wording is simply Use URL Rewriting.

3. Turn on Joomla URL rewriting

1. Return to System → Global Configuration → Site.
2. In SEO, leave Search Engine Friendly URLs set to Yes.
3. Set Use URL Rewriting to Yes. On some Joomla installations this appears as Use Apache mod_rewrite/URL rewriting.
4. Click Save or Save & Close.

Open representative menu items and articles again. Successful pages should now use the readable route without index.php.

If Apache pages fail after the change

Immediately set Use URL Rewriting back to No and save. That rollback leaves SEF URLs available while disabling the server-dependent layer that is failing. Then check, in order:

Rank #3

Sale

Joomla! For Dummies

$13.61

Buy on Amazon

• The file is named exactly .htaccess and is in the Joomla root.
• Apache is allowed to read per-directory overrides for that root.
• The rewrite module is enabled.
• The host’s virtual-host rules do not override or conflict with Joomla’s rules.

After the host corrects the server configuration, enable URL rewriting again and retest several links rather than assuming one successful page proves the whole site works.

Remove index.php with Nginx

1. Add a front-controller route

Nginx does not process Apache .htaccess files. The Nginx server block must route requests that are not existing files or directories to Joomla’s front controller. A standard pattern is:

try_files $uri $uri/ /index.php?$args;

Place that directive in the appropriate Nginx server configuration for the Joomla site, then reload Nginx using the procedure provided by your host or system administrator. Shared hosting customers commonly need the provider to make this change.

2. Enable both Joomla switches

1. Open System → Global Configuration → Site.
2. Under SEO, set Search Engine Friendly URLs to Yes.
3. Set Use URL Rewriting to Yes.
4. Save the configuration.

Test menu links and article links. If the Nginx route is missing or points somewhere else, Joomla may not receive the request correctly; disable Use URL Rewriting until the server rule is corrected.

Rank #4

Sale

Official Joomla! Book (Joomla! Press)

$23.89

Buy on Amazon

Apache and Nginx configurations compared

Both servers use the same Joomla administrator switches. The difference is where the routing rule lives: Apache can use Joomla’s .htaccess, while Nginx requires a server-block rule.

Should you add a suffix such as .html?

Joomla’s Add Suffix to URL option is optional. It appends a suffix such as .html to generated routes, but it is not required for SEF operation or for removing index.php. Joomla’s documentation notes that search engines do not appear to care whether URLs end in .html.

Choose one URL policy and keep it consistent. If your existing site already publishes one format, changing suffix behavior changes the visible addresses and should be treated as a deliberate migration rather than a cosmetic toggle. If you do not have a specific policy requiring a suffix, leaving the option off keeps the route shorter.

How to test the change safely

Test the administrator setting

• Reopen Global Configuration and verify that Search Engine Friendly URLs still shows Yes after saving.
• Open the home page and several top-level menu items.
• Open articles reached through different menus, not just one sample article.

Test Apache rewriting

• Confirm that the address no longer displays index.php.
• Open a direct article URL in a fresh browser tab, rather than arriving only through an internal click.
• If an error appears, turn Use URL Rewriting off, restore service, and check the filename, overrides, and rewrite module before trying again.

Test Nginx rewriting

• Verify that the server block contains the Joomla try_files route.
• Reload Nginx through the host’s documented process.
• Open several menu and article URLs directly after enabling the Joomla setting.
• If requests fail, disable Joomla URL rewriting while the server rule is reviewed.

Check more than one content path

Menu structure and content determine the readable route, so a single working link is not enough to validate a site-wide change. Test representative menu items and articles, including content reached through different menu branches. Extensions can also affect routing; if only one extension’s links fail, isolate that extension’s route while the core Joomla URLs continue to work.

Best Value

Joomla! 4 Masterclass: A practitioner's guide to building rich and modern websites using the brand-new features of Joomla 4

$38.99

Buy on Amazon

Troubleshooting decision guide

Readable URLs work, but index.php remains

SEF is enabled, but URL rewriting is not active. On Apache, check the .htaccess filename, override permission, and rewrite module. On Nginx, add or correct the try_files directive. Then enable Use URL Rewriting and test again.

Errors appear immediately after enabling URL rewriting

Turn the Joomla URL-rewriting switch off and save. The failure indicates that the web-server layer is not ready or its rules are incorrect. Confirm the server type, correct the Apache or Nginx configuration, and only then re-enable the switch.

You do not know whether the site uses Apache or Nginx

Do not guess and enable a server-specific configuration blindly. Ask the hosting provider which web server handles the Joomla site and whether you can use .htaccess overrides or edit the Nginx server block. The provider can also confirm whether rewrite support is enabled.

Only some links fail

Start with Joomla core menu items and articles to determine whether the server route works generally. Then check the menu path and any extension responsible for the failing link. Because SEF routes are built from menu and content structure, an extension or custom route can behave differently from a standard article link.

Recommended order for a production site

1. Identify the web server and confirm who controls its configuration.
2. Enable Search Engine Friendly URLs and test readable routes while index.php may still be present.
3. Prepare the server layer: rename htaccess.txt and verify Apache overrides, or add the Nginx try_files rule.
4. Enable Use URL Rewriting.
5. Test the home page, multiple menu items, and multiple articles directly.
6. If errors occur, disable URL rewriting, correct the server rule, and repeat the tests.
7. Decide separately whether Add Suffix to URL fits the site’s long-term URL policy.

This sequence keeps the Joomla setting and the server rewrite layer distinct, making it clear which change caused a problem and giving you a straightforward rollback.

Quick Recap

SaleBestseller No. 1

Using Joomla!: Efficiently Build and Manage Custom Websites

$22.79

SaleBestseller No. 2

Official Joomla! Book, The (Joomla! Press)

$31.81

SaleBestseller No. 3

Joomla! For Dummies

$13.61

SaleBestseller No. 4

Official Joomla! Book (Joomla! Press)

$23.89

Bestseller No. 5

Joomla! 4 Masterclass: A practitioner's guide to building rich and modern websites using the brand-new features of Joomla 4

$38.99

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.