Sitemap generation

New in version 0.4.

This document describes how to create XML sitemaps for your Wagtail website using the wagtail.contrib.wagtailsitemaps module.

Basic configuration

You firstly need to add "wagtail.contrib.wagtailsitemaps" to INSTALLED_APPS in your Django settings file:

INSTALLED_APPS = [
    ...

    "wagtail.contrib.wagtailsitemaps",
]

Then, in urls.py, you need to add a link to the wagtail.contrib.wagtailsitemaps.views.sitemap view which generates the sitemap:

from wagtail.contrib.wagtailsitemaps.views import sitemap

urlpatterns = patterns('',
    ...

    url('^sitemap\.xml$', sitemap),
)

You should now be able to browse to “/sitemap.xml” and see the sitemap working. By default, all published pages in your website will be added to the site map.

Customising

URLs

The Page class defines a get_sitemap_urls method which you can override to customise sitemaps per page instance. This method must return a list of dictionaries, one dictionary per URL entry in the sitemap. You can exclude pages from the sitemap by returning an empty list.

Each dictionary can contain the following:

  • location (required) - This is the full URL path to add into the sitemap.
  • lastmod - A python date or datetime set to when the page was last modified.
  • changefreq
  • priority

You can add more but you will need to override the wagtailsitemaps/sitemap.xml template in order for them to be displayed in the sitemap.

Cache

By default, sitemaps are cached for 100 minutes. You can change this by setting WAGTAILSITEMAPS_CACHE_TIMEOUT in your Django settings to the number of seconds you would like the cache to last for.