Skip to content
Tutorials Center
My learning

Topics

Lesson 26 of 37 · SEO and Performance

SEO-Friendly URLs and Metadata

Make a Joomla site easy for search engines: SEF URLs and rewriting, aliases, page titles, meta descriptions, robots settings, redirects, structured data and sitemaps.

Search engines do not need magic from your CMS. They need pages that load, have a clear address, a meaningful title and description, a sensible link structure and no duplicate or broken URLs. Joomla gives you most of the tools in its core; the work is knowing where they are and using them consistently.

Joomla cannot run in this site, so the screens are described by path, and two JavaScript stand-ins show how an alias is generated and how much of a title and description a search result can display.

URLs: from index.php?option to words

Without any setting, a Joomla page may be addressed like index.php?option=com_content&view=article&id=17&catid=2. It works but tells nobody anything. The first job is in System > Global Configuration > Site, section SEO:

  • Search Engine Friendly URLs: Yes. Joomla now builds addresses from menu item and article aliases, such as /news/launch-day.
  • Use URL Rewriting: Yes removes index.php from the path (/news/launch-day instead of /index.php/news/launch-day). On Apache it needs the file htaccess.txt renamed to .htaccess and mod_rewrite enabled. On nginx you add equivalent rules to the server configuration, and on IIS you rename web.config.txt to web.config. If you get a 404 or 500 after switching it on, the server rewrite is missing: switch the option off again to regain access.
  • Adds Suffix to URL: appends .html. Neutral for search; choose once and never change it later.
  • Unicode Aliases: allow non-Latin characters in aliases, useful for languages such as Arabic or Cyrillic.
  • Include Site Name in Page Titles: before, after or not at all.

An alias is the lowercase, URL-safe version of a title and is editable on the article, category and menu item. Joomla generates it from the title; you may shorten it. Keep it stable: changing an alias changes the URL.

The path itself comes from the menu structure. A menu item News with an article Launch Day yields /news/launch-day (with the article ID removed in modern Joomla, thanks to the Remove IDs from URLs option of the router in the Articles options). Design the menu tree as you would design the site's directories, and keep it shallow.

JS How an alias is made

Press Run (or Ctrl + Enter) to see the console output here.

No output.

This is a stand-in: Joomla's own OutputFilter::stringURLSafe() follows similar steps (transliteration, replacing characters with hyphens, trimming), and two items with the same alias in the same parent must differ, so Joomla adds a number.

Titles and descriptions

Each page has a <title> and a meta description. Joomla builds them from several places, in this order of precedence:

  1. The menu item: Page Display tab, Browser Page Title, and the Metadata tab for meta description and robots.
  2. The article (or category): Publishing tab, Meta Description and Robots. The Page Title shown in search results comes from the article title unless the menu item overrides it.
  3. The global Site Meta Description in Global Configuration, used when nothing more specific exists.

Write a unique description per important page, roughly 120 to 160 characters, as a human summary. Search engines may rewrite it, but a good one earns more clicks. The old Meta Keywords field is ignored by search engines; leave it empty.

JS Preview a search result

Press Run (or Ctrl + Enter) to see the console output here.

No output.

Pixel widths decide the real cut-off, so treat the numbers as a guide. The second example shows two classic problems: a title that is too long and a description that says almost nothing.

Robots, canonical and duplicates

  • Robots in Global Configuration sets the default (index, follow); override it per item for pages like a thank-you screen (noindex, follow).
  • The root file robots.txt (Joomla ships robots.txt.dist; copy it to robots.txt) controls crawling of folders. Do not block the media and template folders, because search engines need CSS and JavaScript to render the page.
  • Duplicate content arises when the same article is reachable at several URLs (through a category blog, a featured list and a search). Keep one main menu path, and let the System - SEF plugin add canonical links and redirect non-SEF URLs (check its options in your version).
  • Turn off features you do not use, such as unused article views or a category with an empty blog menu item, so no thin pages are generated.

Redirects

When a URL changes or breaks, send the visitor and the crawler to the new address with a 301 redirect. Enable the System - Redirect plugin, and Joomla records every 404 in Components > Redirects. Open an entry, type the new URL, save with Enabled; the old URL now redirects permanently. This is the safest way to keep rankings after a restructure or a migration. For many URLs, use the import/export of the Redirects component or rewrite rules.

Structured data and social previews

Joomla 5 includes a Schema.org system plugin family: it adds JSON-LD (types such as Article, BlogPosting, Organization, Person, Event) to pages and lets you fill the fields in the article's Schema tab. Test the output with a rich-result checker. For Open Graph and Twitter cards the core has no complete tool; use an SEO extension or add the meta tags in the template, using the article's title, description and an image.

Sitemaps and monitoring

Core Joomla does not generate an XML sitemap; use a trustworthy extension, or a hosted generator, then submit the URL in Google Search Console and Bing Webmaster Tools. Those tools also reveal crawl errors, which you fix with redirects.

A short on-page checklist per article:

Check your understanding

Quick check · 4 questions

of 4 answered You scored / 4 · perfect!

  1. 1. What does the Use URL Rewriting option do on Apache?

    Rewriting hides index.php; you must rename htaccess.txt to .htaccess so the server forwards requests.
  2. 2. Which field do search engines ignore today?

    Meta keywords are ignored; descriptions and titles still matter for search snippets.
  3. 3. How do you permanently redirect an old URL in Joomla?

    The Redirect component records 404 URLs and lets you assign a target; the plugin performs the 301.
  4. 4. Why should you avoid blocking the media folder in robots.txt?

    Blocked assets stop crawlers from rendering the page like a visitor sees it.

Summary

  • Turn on SEF URLs, add URL rewriting once the server supports it, and keep aliases short and stable.
  • Titles and descriptions come from menu items, articles and the global setting; write unique ones.
  • Use robots settings carefully, avoid duplicate paths and keep CSS/JS crawlable.
  • Record 404s and add 301 redirects after any change.
  • Add structured data (Schema.org plugin), a sitemap by extension, and monitor with search consoles.

Next: Caching and Compression