Skip to content
⬢ A flexible & powerful XML Sitemap generator for Kirby CMS
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.

Kirby XML Sitemap Release Issues

XML Sitemap is a powerful Kirby CMS plugin that generates a nice sitemap.xml for your site!

Kirby XML Sitemap screenshot

Main features

  • Cache support
  • Human-readable XML sitemap
  • Image attributes
  • Multi-language support
  • Powerful options


  • Kirby 2.4.0+
  • PHP 5.4+


After installing the plugin using any of the methods below you should be able to visit to see an human-readable sitemap without any initial configuration.


Download the files and place them inside site/plugins/xml-sitemap.

Kirby CLI

Kirby's command line interface makes installing the XML Sitemap a breeze:

$ kirby plugin:install pedroborges/kirby-xml-sitemap

Updating couldn't be any easier, simply run:

$ kirby plugin:update pedroborges/kirby-xml-sitemap

Git Submodule

You can add the XML Sitemap as a Git submodule.

$ cd your/project/root
$ git submodule add site/plugins/xml-sitemap
$ git submodule update --init --recursive
$ git commit -am "Add XML Sitemap plugin"

Updating is as easy as running a few commands.

$ cd your/project/root
$ git submodule foreach git checkout master
$ git submodule foreach git pull
$ git commit -am "Update submodules"
$ git submodule update --init --recursive


XML Sitemap works out of the box and most likely you won't need to change any option manually. However there are the following options in case you need to change the defaults:

// License URL for your site's images
c::set('sitemap.images.license', null);

// Enable/disable adding images to XML Sitemap
c::set('sitemap.include.images', true);

// Add/remove invisible pages
c::set('sitemap.include.invisible', false);

// URI of pages to remove
c::set('sitemap.ignored.pages', []);

// Templates names to remove
c::set('sitemap.ignored.templates', []);

// Show/hide change frequency attribute
// (see more below)
c::set('sitemap.frequency', false);

// Show/hide priority attribute
// (see more below)
c::set('sitemap.priority', false);



When this option is set to true the plugin will default to this function to determine the value of the changefreq attribute of URLs on your XML sitemap. You can pass a callback to use your own logic:

c::set('sitemap.frequency', function($page) {
    // You must return a string
    return $page->isHomePage() ? 'daily' : 'never';


When this option is set to true the plugin will default to this function to determine the value of the priority attribute of URLs on your XML sitemap. You can pass a callback to use your own logic:

c::set('sitemap.priority', function($page) {
    // You must return a floating point number between 0 and 1
    return $page->depth() === 1 ? 1 : 0.5;


The XML Sitemap plugin includes options that are enough for most projects. However there are cases in which you need more control. This option allows you to process the pages collection in any way you want, such as removing or adding a specific set of pages.

// Add a page that was removed on the
// `sitemap.ignored.templates` option
c::set('sitemap.process', function($pages) {
    $shy = page('super-shy-page');

    return $pages->add($shy);

// Filter a set of pages based on a field value
c::set('sitemap.process', function($pages) {
    return $pages->filter(function($page) {
        // Remove future posts
        if ($page->intendedTemplate() === 'post') {
            return $page->date() < time();

        // Keep all other pages
        return true;

You can do any number of manipulation on the $pages collection.

Change Log

All notable changes to this project will be documented at:


XML Sitemap is open-sourced software licensed under the MIT license.

Copyright © 2017 Pedro Borges

You can’t perform that action at this time.