Product support

Visit this product's website for support.


  • Miscellaneous
  • Utility

This plugin will a generate sitemap.xml file in OctoberCMS based on desired CMS pages and others.

Viewing the sitemap

Once this plugin is installed and the sitemap has been configured. The sitemap can be viewed by accessing the file relative to the website base path. For example, if the website is hosted at http://octobercms.com/ it can be viewed by opening this URL:


Managing a sitemap definition

The sitemap is managed by selecting Sitemap from the Settings area of the back-end. There is a single sitemap definition for each theme and it will be created automatically.

A sitemap definition can contain multiple items and each item has a number of properties. There are common properties for all item types, and some properties depend on the item type. The common item properties are Priority and Change frequency. The Priority defines the priority of this item relative to other items in the sitemap. The Change frequency defines how frequently the page is likely to change.

Standard item types

The available item types depend on the installed plugins, but there are three basic item types that are supported out of the box.


Items of this type are links to a specific fixed URL. That could be an URL of an or internal page. Items of this type don't have any other properties - just the title and URL.

Static page

Items of this type refer to static pages. The static page should be selected in the Reference drop-down list described below.

All static pages

Items of this type expand to create links to all static pages defined in the theme.

Custom item types

Other plugins can supply new item types. For example, the Blog plugin by RainLab supplies two more types:

Blog category

An item of this type represents a link to a specific blog category. The category should be selected in the Reference drop-down. This type also requires selecting a CMS page that outputs a blog category.

All blog categories

An item of this time expands into multiple items representing all blog existing categories. This type also requires selecting a CMS page.

Definition item properties

Depending on the selected item time you might need to provide other properties of the item. The available properties are described below.


A drop-down list of objects the item should refer to. The list content depends on the item type. For the Static page item type the list displays all static pages defined in the system. For the Blog category item type the list displays a list of blog categories.

Allow nested items

This checkbox is available only for item types that suppose nested objects. For example, static pages are hierarchical, and this property is available for the Static page item type. On the other hand, blog categories are not hierarchical, and the checkbox is hidden.

CMS Page

This drop-down is available for item types that require a special CMS page to refer to. For example, the Blog category item type requires a CMS page that hosts the blogPosts component. The CMS Page drop-down for this item type will only display pages that include this component.

The Sitemap plugin works out of the box and does not require any direct development to operate.

Registering new sitemap definition item types

The Sitemap plugin shares the same events for registering item types as the Pages plugin. See the documentation provided by this plugin for more information.

A small addition is required when resolving items, via the following event:

  • pages.menuitem.resolveItem event handler "resolves" a menu item information and returns the actual item URL, title, an indicator whether the item is currently active, and subitems, if any.
Resolving items

When resolving an item, each item should return an extra key in the array called mtime. This should be a Date object (see Carbon\Carbon) or some other value compatible with PHP's date() function and represent the last time the link was modified.

Expected result format:

Array (
    [url] => http://example.com/blog/category/another-category
    [mtime] => Carbon::now(),
    [items] => Array (
        [0] => Array  (
            [url] => http://example.com/blog/category/another-category
            [mtime] => Carbon::now(),

        [1] => Array (
                [url] => http://example.com/blog/category/news
                [mtime] => Carbon::now(),
  • Found the plugin not useful on 19 Sep, 2016

    No good this plugin, you can only create one sitemap.

  • Found the plugin useful on 13 Nov, 2015

    So useful plugin!

  • Found the plugin useful on 23 Aug, 2015

    Great plugin! Thanks for the contribution!

  • Found the plugin useful on 28 Nov, 2014

    This is a much needed plugin for October. Very flexible, simple, and functional. I love that it just "works" with static menus integrated plugins like ProBlog and ProEvents as well!

  • Found the plugin useful on 20 Nov, 2014



Minor styling updates.

Nov 22, 2016


Added access premissions.

Nov 22, 2016


Minor fix to internal API.

Sep 08, 2015


Minor back-end styling fix.

Jul 10, 2015


Fixes issue where correct headers not being sent.

Mar 13, 2015


Minor improvements to the code.

Feb 25, 2015


Create definitions table

Nov 18, 2014


First version of Sitemap

Nov 18, 2014