Download the PHP package automattic/msm-sitemap without Composer
On this page you can find all versions of the php package automattic/msm-sitemap. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download automattic/msm-sitemap
More information about automattic/msm-sitemap
Files in automattic/msm-sitemap
Package msm-sitemap
Short Description Comprehensive sitemaps for your WordPress.com VIP site.
License GPL-2.0-or-later
Homepage https://github.com/Automattic/msm-sitemap/
Informations about the package msm-sitemap
Metro Sitemap
Stable tag: 1.5.3
Requires at least: 5.9
Tested up to: 6.8
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: sitemap, xml, seo, performance, multisite
Contributors: metro, automattic, alleyinteractive, makermedia, 10up
High-performance XML sitemaps for large-scale WordPress sites. Built for speed, extensibility, and reliability. Metro Sitemap generates robust, scalable XML sitemaps for WordPress sites of any size. Designed for high-traffic and enterprise environments, it ensures your content is discoverable by search engines without slowing down your site.
At a Glance
- Fast, reliable XML sitemaps for large and small sites
- Asynchronous generation avoids timeouts and memory issues
- Supports custom post types (see FAQ)
- Multisite compatible
- WP-CLI support for advanced management
- Extensible via hooks and filters (see developer docs)
- Admin UI for stats, manual actions, and cron management
- Browser-friendly XSL styling with independent stylesheet endpoints
Installation
- Upload the plugin folder to
/wp-content/plugins/
or install via the WordPress admin. - Activate the plugin through the 'Plugins' menu in WordPress.
- (Optional) Visit Tools > Sitemap in the admin for stats and manual actions.
- Sitemaps will be generated automatically in the background.
Usage
- Your sitemap index will be available at
/sitemap.xml
(e.g.,https://example.com/sitemap.xml
). - Sitemaps are generated in the background and updated as you publish new content.
- The admin UI (Tools > Sitemap) provides stats and lets you manually trigger generation if needed.
Automatic Updates
By default, automatic sitemap updates are disabled to prevent resource issues on large sites. To enable automatic updates:
Via Admin UI:
- Go to Tools > Sitemap in your WordPress admin
- In the "Cron Management" section, click "Enable Automatic Updates"
- Once enabled, you can use the "Generate" section to manually trigger sitemap generation
Via WP-CLI:
Important: Automatic updates can use significant resources on sites with many posts. For large sites, consider using date-targeted WP-CLI commands instead (see below).
Frequently Asked Questions
Why isn’t my custom post type included in the sitemap?
By default, only the post
post type is included. To add custom post types (like page
, news
, or others), see the Developer Guide.
How do I include posts with a custom status?
By default, only published posts are included. You can change this via a filter. See the Developer Guide.
How do I regenerate the sitemap?
Sitemaps are generated automatically, but you can:
- Use the admin UI (Tools > Sitemap) to trigger a manual rebuild
- Use WP-CLI commands (see below)
Does it work on multisite?
Yes! Each site in your network will have its own sitemaps. The plugin can be network-activated.
How do I exclude specific posts or dates?
You can filter which posts or dates appear in the sitemap using hooks—see the Developer Guide.
Where is the sitemap stored?
Sitemap XML is stored in a custom post type (msm_sitemap
) and served on-demand for fast performance.
Can I customize the number of posts per sitemap?
Yes, this is filterable. See the Developer Guide.
How do I disable the XSL styling for sitemaps?
If you want to serve plain XML without browser styling, you can disable the XSL stylesheet references:
For more XSL customization options, see the Developer Guide.
WP-CLI Commands
Metro Sitemap supports advanced management via WP-CLI. Here are the most common commands:
Core Commands
-
generate: Generate sitemaps for all or specific dates.
-
delete: Delete sitemaps for all or specific dates.
-
list: List sitemaps.
-
get: Get details for a sitemap by ID or date.
-
validate: Validate sitemaps for all or specific dates.
-
export: Export sitemaps to a directory.
-
recount: Recalculate and update the indexed URL count for all sitemap posts.
- stats: Show sitemap statistics (total, most recent, etc).
Cron Management Commands
-
cron enable: Enable automatic sitemap updates.
-
cron disable: Disable automatic sitemap updates.
-
cron status: Check the status of automatic updates.
- cron reset: Reset cron to clean state (for testing).
For the full list of commands, options, and legacy command mapping, see DEVELOPERS.md.
Support
- GitHub Issues (for bug reports and feature requests)
- WordPress VIP Support (for WPVIP customers)
Credits
Metro Sitemap is a joint collaboration between Metro.co.uk, WordPress VIP, Alley Interactive, Maker Media, 10up, and others. Special thanks to all contributors.
Changelog
See CHANGELOG.md for a full history of changes.
License
GPLv2 or later. See LICENSE for details.
Developer Documentation
For advanced customization, see DEVELOPERS.md.