spatie/laravel-sitemap

Create and generate sitemaps with ease

8.0.1 2026-03-02 13:55 UTC

Requires

• php: ^8.4
• illuminate/support: ^12.0|^13.0
• nesbot/carbon: ^2.71|^3.0
• spatie/crawler: ^9.0
• spatie/laravel-package-tools: ^1.16.1

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.13
• orchestra/testbench: ^10.0|^11.0
• pestphp/pest: ^4.0
• phpstan/extension-installer: ^1.3
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• spatie/pest-plugin-snapshots: ^2.1
• spatie/temporary-directory: ^2.2

MIT

• Freek Van der Herten

• spatie
• laravel-sitemap

README

Generate sitemaps with ease

This package can generate a sitemap without you having to add URLs to it manually. This works by crawling your entire site.

use Spatie\Sitemap\SitemapGenerator;

SitemapGenerator::create('https://example.com')->writeToFile($path);

You can also create your sitemap manually:

use Carbon\Carbon;
use Spatie\Sitemap\Sitemap;
use Spatie\Sitemap\Tags\Url;

Sitemap::create()
    ->add(Url::create('/home')
        ->setLastModificationDate(Carbon::yesterday()))
    ->add(...)
    ->writeToFile($path);

Or you can have the best of both worlds by generating a sitemap and then adding more links to it:

use Spatie\Sitemap\SitemapGenerator;
use Spatie\Sitemap\Tags\Url;

SitemapGenerator::create('https://example.com')
    ->getSitemap()
    ->add(Url::create('/extra-page')
        ->setLastModificationDate(Carbon::yesterday()))
    ->add(...)
    ->writeToFile($path);

You can also add your models directly by implementing the Sitemapable interface.

use Spatie\Sitemap\Contracts\Sitemapable;
use Spatie\Sitemap\Tags\Url;

class Post extends Model implements Sitemapable
{
    public function toSitemapTag(): Url | string | array
    {
        return route('blog.post.show', $this);
    }
}

Support us

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.

Documentation

All documentation is available on our documentation site.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you've found a bug regarding security please mail [e-mail] instead of using the issue tracker.

Credits

• Freek Van der Herten
• All Contributors

License

The MIT License (MIT). Please see License File for more information.