Download the PHP package mage2kishan/module-xml-sitemap without Composer

Magento 2 XML Sitemap Extension: Sharding, Hreflang, Image & Video Tags (Hyva + Luma)

A complete XML sitemap replacement for Magento 2. Panth XML Sitemap adds per-store sitemap profiles, seven entity contributors, hreflang alternate tags, image and video tags, automatic shard splitting, gzip compression, search-engine ping, delta tracking, an async queue, a daily cron, and a CLI command. Works identically on Hyva and Luma.

Product page: kishansavaliya.com/magento-2-xml-sitemap.html

Quick Answer

What is Panth XML Sitemap? It is a Magento 2 sitemap extension that replaces the native single-blob sitemap pipeline with a sharded, delta-tracked generator that handles hreflang, images, video, gzip, and search-engine ping out of the box.

What does it add to my store?

• Per-store sitemap profiles so each store view can have its own contributor list, shard size, gzip setting, and cron schedule.
• Seven entity contributors: product, category, CMS page, landing page, blog, video, and additional links.
• Hreflang alternate tags for multi-language stores, added per URL inside each shard.
• Image and video sitemap tags so Google Image Search and video results can index your media.
• Auto-sharding that splits files at a configurable URL cap and closes early if a shard would exceed 45 MB.
• Delta tracking so only changed entities regenerate on each cron run.
• Google and Bing ping after every successful write.
• A CLI command for CI pipelines and manual rebuilds.

Which themes are supported? Both Hyva and Luma. The sitemap is a backend-only pipeline; there is no frontend JavaScript, so it works with any theme.

What does it need? Magento 2.4.4 to 2.4.8, PHP 8.1 to 8.4, and the free mage2kishan/module-core package.

Need Custom Magento 2 Development?

Get a free quote for your project in 24 hours for custom modules, Hyva themes, performance work, M1 to M2 migrations, and Adobe Commerce Cloud.

Visit our website: kishansavaliya.com  |  Get a quote: kishansavaliya.com/get-quote

Table of Contents

• Who Is It For
• Key Features
• Screenshots
• Compatibility
• Installation
• Configuration
• Managing Sitemap Profiles
• How It Works
• CLI
• Cron
• FAQ
• Support
• About Panth Infotech
• Quick Links

Who Is It For

• Stores with large catalogs where Google's 50,000 URL and 50 MB per-file limits mean the native sitemap silently drops URLs. Panth XML Sitemap splits into as many shards as needed.
• Multi-language stores that need hreflang alternate links inside every sitemap entry so search engines serve the right language version to each audience.
• Stores with rich media that want product images and videos indexed by Google Image and Video Search.
• Merchants who want fast nightly rebuilds because the delta tracker skips shards whose source entities have not changed since the last run.
• Development teams that need a CLI command to regenerate sitemaps in CI pipelines after deploys.

Key Features

Per-Store Sitemap Profiles

• One profile per store view with its own contributor list, shard size, gzip flag, hreflang flag, cron schedule, and active toggle.
• Profile grid in admin at Admin - Panth Infotech - XML Sitemap - Sitemap Profiles with inline Edit, Generate Now, View Sitemap, and Delete actions.
• Mass actions: Enable, Disable, Regenerate Now, and Delete for multiple profiles at once.
• Base URL override so CDN domains or alternate apex hosts are handled correctly per store.

Seven Entity Contributors

• Product contributor walks enabled, visible products, reads canonical URLs from url_rewrite, and emits <lastmod>, <changefreq>, and <priority> per URL.
• Category contributor walks active categories at the store's root, respecting the store's root category.
• CMS page contributor includes all active CMS pages, excluding the homepage, no-route, cookie notice, and any admin-configured extra identifiers.
• Landing page contributor auto-enabled when Panth Landing Pages module is present; self-disables otherwise.
• Blog contributor auto-detects supported third-party blog modules and self-disables when none are installed.
• Video contributor emits <video:video> blocks for products with external video media gallery items.
• Additional links contributor reads a free-form textarea of custom URLs (one per line) for campaign pages or any URL that does not live in a content table.

Hreflang, Image & Video Tags

• Hreflang alternate tags add <xhtml:link rel="alternate" hreflang="xx-YY"> entries per URL when the store has two or more locale codes, including x-default.
• Image tags add <image:image> blocks with image URL, title, and caption for every gallery image on a product URL.
• Video tags add <video:video> blocks (title, description, content URL, thumbnail, duration) for products with associated video media.
• Configurable image source: choose base image, small image, or thumbnail for sitemap entries.

Auto-Sharding and Gzip

• Auto-split at a configurable URL cap (default 45,000, well under Google's 50,000 hard limit). Shards are named sitemap-1.xml, sitemap-2.xml, and so on.
• Early close at 45 MB uncompressed to stay under the 50 MB per-file cap.
• Gzip compression writes shards as .xml.gz with Content-Encoding: gzip. A typical catalog compresses about 10:1, so a 45 MB shard ships as roughly 4.5 MB.
• XSL stylesheet can be injected into every shard so the sitemap renders as a human-readable table in a browser while remaining a valid XML file for crawlers.

Search-Engine Ping and Delta Tracking

• Ping Google and Bing after every successful write. Each engine can be enabled or disabled independently per profile.
• Delta tracker records last_generated_at per entity in panth_seo_sitemap_shard. The next cron run skips shards whose source entities have not changed. Typical nightly time drops from 90 seconds to 5 seconds on a 50k-product store.
• Force flag on the CLI bypasses the delta tracker for a full rebuild when needed.

Async Queue, Cron, and CLI

• Async AMQP shard queue dispatches each shard to the panth_xml_sitemap.shard topic when enabled; a worker pool builds shards in parallel.
• Nightly cron at 0 2 * * * by default; each profile can override with its own cron expression.
• CLI command panth:seo:sitemap:generate for manual and CI-driven runs, with --profile-id and --force flags.
• Frontend endpoint /panth-sitemap.xml served by the module controller via a url_rewrite row installed at setup time.

Exclude Flags

• Exclude out-of-stock products to avoid indexing unavailable items.
• Exclude NOINDEX pages to keep the sitemap consistent with your robots meta directives.
• Per-profile excluded CMS identifiers textarea to drop specific CMS pages from the CMS shard.

Screenshots

Live walkthrough

End-to-end admin flow: open the XML Sitemap config, toggle fields, edit the default profile, flip entity types and priorities, run Generate Now, and click View Sitemap.

System configuration

Stores - Configuration - Panth Extensions - XML Sitemap with six collapsible groups (General, Generation, Hreflang, Images & Video, Search Engine Ping, Additional Links).

Sitemap Profiles grid

One row per profile with columns for ID, Name, Store View, Entity Types, Active, URL Count, File Count, Last Generated, and per-row actions.

Edit Sitemap Profile form

Eight collapsible sections covering every profile setting, with a read-only Generation Status block populated after each run.

XSL rendered sitemap

The XSL stylesheet renders a human-readable table in the browser while the response stays valid XML for crawlers.

Compatibility

Installation

Composer Installation (Recommended)

Manual Installation via ZIP

1. Download the latest release from Packagist or from the product page.
2. Extract it to app/code/Panth/XmlSitemap/ in your Magento install.
3. Make sure Panth_Core is installed too (required dependency).
4. Run the commands above starting from bin/magento module:enable.

Verify Installation

After install, open:

Configuration

Go to Admin - Panth Infotech - XML Sitemap - Configuration (or Stores - Configuration - Panth Extensions - XML Sitemap).

Every setting resolves at store-view scope, so each store can have a different configuration.

General

Generation

Hreflang

Images & Video

Search Engine Ping

Additional Links

Managing Sitemap Profiles

Open Admin - Panth Infotech - XML Sitemap - Sitemap Profiles.

Each profile row is scoped to a single store view and carries its own settings for contributor list, shard size, gzip, hreflang, images, video, cron schedule, and active flag.

Key Profile Fields

How It Works

1. Setup\Patch\Data\InstallSitemapRewrite installs a url_rewrite row that maps /panth-sitemap.xml to the module controller at setup time. No manual DB work is needed.
2. A Sitemap Profile defines which entities to include, how to split shards, and when to regenerate. Each profile is scoped to one store view.
3. Model\Sitemap\Builder is the orchestrator. It resolves the store scope, iterates registered contributors in a fixed order, pipes each URL through ShardWriter, closes shards at the configured threshold, writes the top-level sitemap_index.xml, saves run metadata to the delta table, and pings search engines on success.
4. Contributors are plugged in through di.xml and can be enabled or disabled per profile. Each contributor queries its entity table, resolves canonical URLs from url_rewrite, and yields URL objects with <lastmod>, <changefreq>, <priority>, plus optional hreflang, image, and video blocks.
5. ShardWriter writes one XML file at a time, closing and opening a new shard when the URL count reaches the cap or the uncompressed size would exceed 45 MB.
6. DeltaTracker records a last_generated_at timestamp per entity type after each successful run. The next run compares these timestamps and skips whole contributor shards that have not changed.
7. SearchEnginePinger POSTs to Google and Bing after a successful build with a 5-second timeout and one retry on server errors.
8. Cron\Rebuild fires on the configured schedule. For async-enabled profiles it dispatches shard jobs to the AMQP queue; for synchronous profiles it calls Builder::generate() directly.
9. Console\GenerateCommand exposes panth:seo:sitemap:generate for manual and CI-driven runs.

Sitemap index shape

Individual shard shape

CLI

Exit codes: 0 on success, 1 on fatal error, 2 on partial success (one contributor failed, others completed).

Cron

The default cron job runs at 0 2 * * * (02:00 daily):

Each profile can override the schedule with its own cron expression. The cron runner only dispatches a profile when its schedule matches the current run window and its Active flag is Yes.

When any profile has the async queue enabled, start the consumer as a long-running process:

FAQ

Does this replace Magento's native sitemap?

No. Panth XML Sitemap uses its own URL /panth-sitemap.xml (served by the module controller via a url_rewrite row), so Magento's native sitemap at its existing path is unaffected. You can run both during a transition period and then remove the native one when ready.

Why would I use this instead of the native sitemap?

The native Magento sitemap is a single blob written to disk on every cron run, re-crawling every product each time. It has no hreflang, no sharding (so large catalogs silently drop URLs past 50,000), no image or video tags, no incremental regeneration, and no ping-on-write. Panth XML Sitemap solves all of those gaps.

Will it work on my Hyva store?

Yes. The sitemap pipeline is entirely backend (PHP). There is no frontend JavaScript, so it works with Hyva, Luma, and any custom theme.

How do I see if the sitemap was generated correctly?

Open Admin - Panth Infotech - XML Sitemap - Sitemap Profiles, find your profile row, and click "View Sitemap". You can also visit /panth-sitemap.xml directly in the browser and the XSL stylesheet (if enabled) renders it as a readable table.

Hreflang tags are not appearing in the shards. Why?

Hreflang only fires when the store has two or more store views with different locale codes. A single-locale store has no alternates to emit, so the contributor is a no-op. Confirm you have at least two locale codes configured under Stores - Store Views.

How does delta tracking work?

After each successful run the module saves a last_generated_at timestamp per entity type in panth_seo_sitemap_shard. On the next cron run, the builder compares those timestamps against the entity tables and skips contributors whose data has not changed. Run the CLI with --force to bypass delta tracking and do a full rebuild.

The sitemap returns a 404. How do I fix it?

Run bin/magento setup:upgrade to have the InstallSitemapRewrite (or RefreshSitemapRewrite) patch install or repair the url_rewrite row. Then flush the config and full-page cache. Also check that the module is enabled and that the master toggle in configuration is set to Yes.

Can I add custom URLs that are not product, category, or CMS pages?

Yes. Use the Additional Links textarea in configuration (Stores - Configuration - Panth Extensions - XML Sitemap - Additional Links) or add a Custom Links section to a profile. Enter one URL per line.

Does it support async generation for large stores?

Yes. Enable the queue flag on any profile and start the consumer bin/magento queue:consumers:start panth_xml_sitemap_consumer. Each shard is dispatched to the panth_xml_sitemap.shard AMQP topic and built in parallel.

Support

Response time: 1-2 business days.

Need Custom Magento Development?

Looking for custom Magento module development, Hyva theme work, store migrations, or performance tuning? Get a free quote in 24 hours:

About Panth Infotech

Built and maintained by Kishan Savaliya (kishansavaliya.com), a Top Rated Plus Magento developer on Upwork with 10+ years of eCommerce experience.

Panth Infotech is a Magento 2 development agency that builds high quality, security focused extensions and themes for both Hyva and Luma storefronts. The extension suite covers SEO, performance, checkout, product presentation, customer engagement, and store management, with each module built to MEQP standards and tested across Magento 2.4.4 to 2.4.8.

Browse the full extension catalog on our Magento extensions page or on Packagist.

Quick Links

Ready to give search engines a complete, well-structured sitemap?

SEO Keywords: magento 2 xml sitemap, magento 2 sitemap extension, magento 2 sitemap module, magento sharded sitemap, magento sitemap sharding, magento hreflang sitemap, magento image sitemap, magento image tags sitemap, magento video sitemap, magento video tags sitemap, magento sitemap gzip, magento sitemap compression, magento sitemap search engine ping, magento sitemap cron, magento sitemap cli, magento sitemap generator, magento delta sitemap, magento incremental sitemap, hyva xml sitemap, hyva sitemap extension, luma xml sitemap, magento 2 sitemap index, magento 2 multi-store sitemap, magento 2 sitemap profile, magento 2.4.8 sitemap, php 8.4 sitemap, mage2kishan xml sitemap, panth xml sitemap, panth infotech, hire magento developer, top rated plus upwork, kishan savaliya magento, custom magento development