Configuration

How to Enable and Configure Joomla's Search-Friendly URLs

How to Enable and Configure Joomla's Search-Friendly URLs

Search-friendly URLs remove index.php and IDs from Joomla links. Switch on SEF URLs and URL rewriting in Global Configuration and rename htaccess.txt.

Search-friendly URLs (also known as SEF URLs) make your Joomla website more accessible to both search engines and human visitors. This quick tutorial will walk you through enabling and configuring this essential feature.

Benefits of Search-Friendly URLs

  • Improved SEO - Search engines prefer descriptive URLs
  • Enhanced user experience - Users can better understand where links lead
  • Increased click-through rates - Clear URLs inspire more confidence
  • Better sharing - Clean URLs look more professional when shared

Prerequisites

Before enabling SEF URLs, ensure your server meets these requirements:

  • Apache server with mod_rewrite enabled
  • Or Nginx with proper rewrite rules configured
  • Access to rename or modify the htaccess.txt file

Step-by-Step Configuration

Step 1: Enable Search-Friendly URLs

  1. Log in to your Joomla Administrator panel
  2. Navigate to System → Global Configuration
  3. Click on the Site tab
  4. Find the SEO Settings section
  5. Set Search Engine Friendly URLs to "Yes"
  6. Set Use URL Rewriting to "Yes"
  7. Click Save

Step 2: Configure the .htaccess File

  1. Locate the htaccess.txt file in your Joomla root directory
  2. Rename it to .htaccess (note the leading dot)
  3. If you already have a .htaccess file, make a backup before modifying it

Step 3: Test Your Configuration

  1. Navigate to any article on your frontend
  2. Check the URL in your browser address bar
  3. It should now display a descriptive URL instead of query parameters

Step 4: Advanced SEF Configuration (Optional)

  1. Return to System → Global Configuration → Site tab
  2. Configure these additional options:
    • Add Suffix to URLs: Choose whether to add .html to your URLs
    • Unicode Aliases: Enable for non-Latin character support
    • Include Site Name in Page Titles: Usually recommended for branding

Troubleshooting Common Issues

URLs Not Working After Enabling SEF

  1. Check if your server supports URL rewriting
  2. Verify that your .htaccess file is properly renamed and has correct permissions
  3. Try adding these lines to your .htaccess file if using Apache:  
    RewriteEngine On
    RewriteBase /

404 Errors After Enabling SEF

  1. Check your server configuration for proper rewrite rules
  2. Verify permissions on the .htaccess file (typically 644)
  3. Temporarily disable SEF to restore site functionality while troubleshooting

Conclusion

Enabling search-friendly URLs is one of the simplest yet most effective SEO improvements you can make to your Joomla website. With this configuration in place, your site will be more accessible to both search engines and users.

For more Joomla optimization tips, visit doctorjoomla.com!

Stuck on something else?

Doctor Joomla is a project of Cloudfaction, a Dutch agency building and maintaining Joomla sites since 1999. The articles are made with the help of AI, so tell us if something does not match your screen. Mail info@cloudfaction.nl if you want someone to look at yours.

Rather have someone look at it

Doctor Joomla is a Cloudfaction project.

A Dutch agency that has been building and running Joomla sites since 1999. If your site needs more than an article can fix, get in touch.