Joomla Sitemap: How to Generate and Submit an XML Sitemap
Joomla 3 vs Joomla 4: Sitemap Options
Joomla 3 includes a built-in XML Sitemap component that generates a basic HTML sitemap, not a proper XML sitemap for search engines. It's rarely useful for SEO. Joomla 4 improved the core SEO features but still lacks a native XML sitemap generator. Both Joomla 3 and Joomla 4 users need an extension to generate a proper XML sitemap for Google.
The most widely recommended extension is OSMap, developed by Joomlashack. It was created as the official replacement for xmap (which was the gold standard for years but has been abandoned and is no longer maintained or compatible with modern Joomla versions). OSMap is actively maintained, compatible with Joomla 3 and 4, free for the core version, and supports a wide range of content types via plugins.
Installing and Configuring OSMap
Download OSMap from the Joomla Extensions Directory (JED) or from joomlashack.com. Install it via Joomla's Extension Manager: go to System > Install > Extensions and upload the package file. OSMap installs as a component with companion plugins for each content type.
After installation, navigate to Components > OSMap. You'll need to create a sitemap object by clicking "New." Give it a name, select which menu items to include, and save. OSMap reads your Joomla menu structure and generates sitemap entries based on the linked content. This menu-centric approach means every URL you want in your sitemap must be accessible via a menu item — either directly or through a category view that lists articles.
Your XML sitemap URL will be: https://yourdomain.com/index.php?option=com_osmap&view=xml&sitemap=1 where the number at the end corresponds to your OSMap sitemap ID. If you have Search Engine Friendly (SEF) URLs enabled in Joomla's Global Configuration, OSMap may also be accessible at a cleaner URL.
Content Types OSMap Covers
OSMap uses a plugin system to support different content types. The core installation includes support for: Joomla Articles and Article Categories, Joomla Menu Items (all types), Weblinks (Joomla's built-in web link manager), Contacts, and Newsfeeds. Additional OSMap plugins are available for popular third-party components including K2, EasyBlog, VirtueMart (ecommerce), and others — these are typically installed separately.
After installing OSMap plugins, enable them in Joomla's Plugin Manager (System > Manage > Plugins, search for "osmap"). Each content type plugin must be enabled for OSMap to discover and include those URLs in your sitemap. Regenerate your sitemap after enabling new plugins to see the updated URL list.
Multilingual Joomla Sitemaps with hreflang
Joomla has strong multilingual support built in, and OSMap handles multilingual sitemaps as well. When you have multiple languages configured via Joomla's Language Filter plugin, OSMap generates separate sitemap entries for each language variant of your content. The OSMap Pro version adds hreflang sitemap support, which is important for telling Google which language version to serve in which country.
For a multilingual Joomla site, you can also take the approach of submitting a separate sitemap per language in Google Search Console. Create separate OSMap sitemap objects for each language (by selecting only the menus for that language) and submit each to GSC as a separate sitemap file. This gives you cleaner per-language data in GSC's coverage reports.
Common Joomla Sitemap Issues
Sitemap URL returns 404: Check that OSMap is installed and enabled, and that you're using the correct sitemap ID in the URL. Also verify your Joomla site's SEF settings — if SEF is enabled but your .htaccess isn't configured correctly, dynamic URLs like ?option=com_osmap may fail.
Missing articles in sitemap: OSMap generates sitemap entries based on menu items. If an article is not linked from any menu item (even a hidden one), OSMap may not include it. Create a hidden menu item (in an unpublished menu) linking to the article's category or directly to the article to force OSMap to discover it.
Duplicate URLs: If you have the same article accessible through multiple menu paths, OSMap may list it multiple times. Review your sitemap's XML output and look for identical <loc> values. Use OSMap's exclude options to remove duplicate menu items from sitemap generation.
Submitting Your Joomla Sitemap to Google
Copy your full OSMap XML sitemap URL (including the query string if needed) and submit it in Google Search Console under Indexing > Sitemaps. Also add it to your Joomla site's robots.txt file. In Joomla, the robots.txt is in your site's root directory — edit it via FTP or File Manager and add: Sitemap: https://yourdomain.com/index.php?option=com_osmap&view=xml&sitemap=1.
Joomla 5 and OSMap Compatibility
Joomla 5.0 was released in October 2023 and represents a major version jump from Joomla 4 (Joomla 3 reached end-of-life in August 2023). OSMap has been updated for Joomla 5 compatibility — always check the JED listing for the minimum supported Joomla version before installing or upgrading. Do not assume an extension version that worked on Joomla 4 will work without issues on Joomla 5.
If you're migrating from Joomla 3 to Joomla 4 or 5, your OSMap configuration does not automatically transfer. You'll need to recreate your sitemap objects after migration and re-enable any OSMap plugins for your content types. After any major Joomla version upgrade, verify your sitemap URL still returns valid XML by visiting it directly in a browser — a PHP error or blank page after upgrading is a sign that OSMap needs updating or a conflicting plugin is interfering.
Note that the core Joomla XML sitemap component from Joomla 3 is not available in Joomla 5. If you relied on the core component rather than OSMap, you will need to install OSMap (or another compatible extension) after upgrading to Joomla 4 or 5 to restore XML sitemap generation.
Validating Your Joomla Sitemap XML
Before submitting your Joomla sitemap to Google, validate the XML directly. Visit your sitemap URL in a browser — a correctly formatted XML sitemap will display as structured XML with the <urlset> root element and individual <url> entries visible. If you see a PHP error, 404, or blank page, OSMap isn't generating correctly. For deeper validation, paste your sitemap URL into SitemapFixer's analyzer or Google Search Console's URL inspection tool.
Common XML errors in Joomla sitemaps: special characters in article titles or URLs that aren't properly escaped (the & character in URLs must be written as & in XML), URLs with non-UTF-8 characters from old Joomla 1.5 or 2.5 migrations, and absolute URLs using the wrong domain if your site's live URL isn't correctly set in Joomla's Global Configuration under System > Global Configuration > Site.
A single invalid XML character breaks the entire sitemap — Google cannot parse anything after the invalid character. Fix these errors before submitting to GSC. If you're seeing "Sitemap could not be read" errors in Search Console, XML validation should be your first step. Use an online XML validator to identify the exact line and character causing the parse failure.