Panth HTML Sitemap — Customer-facing /sitemap Page for Magento 2 (Hyva + Luma)

A complete, theme-agnostic HTML sitemap page for Magento 2 at /sitemap — categories as a nested tree, products in a paginated grid that handles 100k+ catalogs, CMS pages, store switcher and custom links. Works identically on Hyva and Luma. Plain PHP + vanilla JS + scoped CSS — no Alpine / RequireJS / mage-init glue.

Magento's built-in XML sitemap is for Google. This module is for humans — a readable page your customers land on when they're lost, and an internal-linking surface that spreads PageRank across every category and product on your store.

Preview

Admin Configuration

All 15 toggles at Stores → Configuration → Panth Infotech → HTML Sitemap — master switch, show categories (with max-depth limit), show products (with sort order, URL structure, pagination), show CMS pages (with exclude list), show store switcher, show custom links, meta title / description, client-side search field, and products-per-page (50–2000, default 500 — the sitemap handles 100k+ products via ?p=N pagination).

Frontend — Hyvä theme

Native Hyvä styling — gradient hero with live counts (categories / products / pages), sticky "On this page" sidebar, and a scoped stylesheet so nothing leaks into the theme's Tailwind bundle.

Frontend — Luma theme

Identical markup on Luma — the template is plain PHP + vanilla JS + prefix-scoped CSS (.panth-htmlsitemap), so the same rendering logic produces the same output under Luma's RequireJS layer without any theme-specific overrides.

Need Custom Magento 2 Development?

Kishan Savaliya

Top Rated Plus on Upwork

Panth Infotech Agency

Table of Contents

• Features
• Scales to 100k+ Products
• Compatibility
• Installation
• Admin Configuration
• Hiding a Category
• Troubleshooting
• Support

Features

• /sitemap URL — clean custom-router URL, no /seo/ or /htmlsitemap/ prefix visible to customers.
• Nested category tree — respects store root, max-depth limit, is_active, and a per-category exclude_from_html_sitemap flag.
• Product grid with pagination — ?p=N pagination for large catalogs, admin-configurable page size (50–2000, default 500), absolute hard cap of 2,000 pages, efficient COUNT(DISTINCT) + LIMIT/OFFSET on indexed EAV joins.
• Product sort options — name A→Z, name Z→A, newest, oldest, price ascending, position.
• Short vs category URLs — choose whether product links are /product.html or /category/product.html.
• CMS pages list — excludes homepage + no-route automatically; admin-configurable extra exclusions (e.g. privacy-policy,cookie-policy).
• Store switcher — optional list of all active stores with their base URLs.
• Custom links — free-form admin textarea, one link per line (URL | Label).
• Client-side search — optional search box filters the visible sections in real time, no network calls.
• SEO-friendly meta — admin-configurable meta title and meta description.
• Theme-agnostic rendering — plain PHP + inline vanilla JS + prefix-scoped CSS class. No Alpine, no RequireJS, no mage-init.

Scales to 100k+ Products

The product section is designed for real catalogs:

• Pagination: default 500 products per page via ?p=N. Admin-configurable 50–2000.
• Absolute hard cap: 2,000 pages regardless of catalog size — beyond that an XML sitemap is the right tool.
• Efficient queries: one COUNT(DISTINCT e.entity_id) for total count (memoised per request), then LIMIT/OFFSET on the paged SELECT. No array_slice on giant arrays, no full catalog load into memory.
• Indexed joins only: catalog_product_entity × catalog_product_website × catalog_product_entity_int (visibility + status) — every filter column is indexed in stock Magento.

Benchmarked render time per page is roughly constant regardless of total catalog size: the sitemap page for product #50,000 renders as fast as the one for product #1.

Compatibility

Installation

composer require mage2kishan/module-html-sitemap
bin/magento module:enable Panth_Core Panth_HtmlSitemap
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Verify

bin/magento module:status Panth_HtmlSitemap
# Module is enabled

Then visit https://your-store.example/sitemap.

Admin Configuration

Navigate to Stores → Configuration → Panth Infotech → HTML Sitemap. A direct link also appears under the Panth Infotech admin sidebar.

Hiding a Category

Every category now has an "Exclude from HTML Sitemap" field in Catalog → Categories → {category} → Search Engine Optimization. Flip it to Yes to hide that category (and its link-children reset to the catalog root, not the hidden category) from the rendered tree. Flush the sitemap's layout cache after changes.

Troubleshooting

/sitemap returns 404

Check the master toggle: Stores → Configuration → Panth Infotech → HTML Sitemap → Enable HTML Sitemap must be Yes. If the module is installed but the config was never saved, the config.xml default (enabled=1) still applies — flush config cache.

Products page shows empty after pagination

Two causes: (a) ?p=N is beyond the last page — clamp client-side to getTotalProductPages(); (b) the visible-product join returns nothing because the store has no products with visibility IN (2,4) and status = 1. Run SELECT COUNT(*) FROM catalog_product_entity to sanity-check the catalog.

DI compile fails after composer require

Ensure Panth_Core, Magento_Store, Magento_Catalog, Magento_Cms and Magento_Eav are all enabled — they are hard dependencies.

Support

• Issues: github.com/mage2sk/module-html-sitemap/issues
• Agency: Panth Infotech on Upwork
• Direct: kishansavaliya.com — Get a free quote