Skip to content


Repository files navigation

Bridgetown Sitemap Generator Plugin

Tests Gem Version

Bridgetown plugin to silently generate a compliant sitemap for your Bridgetown site


  1. Install the plugin with the following command:
bundle add bridgetown-sitemap
  1. Add the following to your site's config/initializers.rb:
Bridgetown.configure do |config|
  config.url = "" # the base hostname & protocol for your site

  init :"bridgetown-sitemap"

<lastmod> tag

The <lastmod> tag in the sitemap.xml will reflect by priority:

  1. A personalised date if you add the variable last_modified_at: with a date in the Front Matter. (Dates need to be formatted as %Y-%m-%d %H:%M:%S %z)
  2. The modified date of the file as reported by git log.

<priority> and <changefreq> tag

You can optionally specify a priority and change frequency for each page in your site by adding the following to the Front Matter of each page:

sitemap_priority: 0.7
sitemap_change_frequency: weekly

This will add the following to the <url> tag in the sitemap.xml:



If you would like to exclude specific pages from the sitemap set the sitemap flag to false in the front matter for the page.

sitemap: false

To exclude multiple files, add a glob config to your config/initializers.rb file.

Bridgetown.configure do |config|
  # ...

  config.defaults << {
    "scope" => { "path" => "assets/**/*.pdf" },
    "values" => { "sitemap" => false }


  • Run bundle exec rake test to run the test suite
  • Or run script/cibuild to validate with Rubocop and run tests together.


  1. Fork it (
  2. Clone the fork using git clone to your local development machine.
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create a new Pull Request


Bridgetown Sitemap is released under the MIT License.

Copyright © 2023 Ayush Newatia