- Multilingual (Implements
rel="alternate"
with@strapi/plugin-i18n
) - Auto-updating (Uses lifecycle methods to keep the sitemap XML up-to-date)
- URL bundles (Bundle URLs by type and add them to the sitemap XML)
- Dynamic paths (Implements URL patterns in which you can inject dynamic fields)
- Exclude URLs (Exclude specified URLs from the sitemap)
- Custom URLs (URLs of pages which are not managed in Strapi)
- Styled with XSL (Human readable XML styling)
Install the plugin in your Strapi project.
# using yarn
yarn add strapi-plugin-sitemap
# using npm
npm install strapi-plugin-sitemap --save
After successful installation you have to rebuild the admin UI so it'll include this plugin. To rebuild and restart Strapi run:
# using yarn
yarn build --clean
yarn develop
# using npm
npm run build --clean
npm run develop
The Sitemap plugin should appear in the Plugins section of Strapi sidebar after you run app again.
Enjoy 🎉
Complete installation requirements are the exact same as for Strapi itself and can be found in the Strapi documentation.
Supported Strapi versions:
- Strapi 4.0.0 (recently tested)
- Strapi ^4.x
- Strapi ^3.4.x (use
strapi-plugin-sitemap@1.2.5
)
(This plugin may work with older Strapi versions, but these are not tested nor officially supported at this time.)
We recommend always using the latest version of Strapi to start your new projects.
With this plugin you have full control over which URLs you add to your sitemap XML. Go to the admin section of the plugin and start adding URLs. Here you will find that there are two ways to add URLs to the sitemap. With URL bundles and Custom URLs.
A URL bundle is a set of URLs grouped by type. When adding a URL bundle to the sitemap you can define a URL pattern which will be used to generate all URLs in this bundle. (Read more about URL patterns below)
URLs coming from a URL bundle will get the following XML attributes:
<loc>
<lastmod>
<priority>
<changefreq>
A custom URL is meant to add URLs to the sitemap which are not managed in Strapi. It might be that you have custom route like /account
that is hardcoded in your front-end. If you'd want to add such a route (URL) to the sitemap you can add it as a custom URL.
Custom URLs will get the following XML attributes:
<loc>
<priority>
<changefreq>
To create dynamic URLs this plugin uses URL patterns. A URL pattern is used when adding URL bundles to the sitemap and has the following format:
/pages/[my-uid-field]
Fields can be injected in the pattern by escaping them with []
.
The following field types are by default allowed in a pattern:
- id
- uid
Allowed field types can be altered with the allowedFields
config. Read more about it below.
When adding a URL bundle of a type which has localizations enabled you will be presented with a language dropdown in the settings form. You can now set a different URL pattern for each language.
For each localization of a page the <url>
in the sitemap XML will get an extra attribute:
<xhtml:link rel="alternate">
This implementation is based on Google's guidelines on localized sitemaps.
To make sure search engines are able to find the sitemap XML create a robots.txt
file in the front-end of your website and add the following line:
Sitemap: https://your-strapi-domain.com/sitemap/index.xml
Read more about the robots.txt
file here.
Settings can be changed in the admin section of the plugin. In the last tab (Settings) you will find the settings as described below.
The hostname is the URL of your website. It will be used as the base URL of all URLs added to the sitemap XML. It is required to generate the XML file.
required:
YES |type:
string |default:
''
If you are using this plugin in a multilingual Strapi project you will be presented with a 'Hostname overrides' setting. With this setting you can set a specific hostname per language.
This is handy for when you have a URL structure like this:
- https://en.domain.com (english domain)
- https://nl.domain.com (dutch domain)
- https://de.domain.com (german domain)
required:
NO |type:
object |default:
{}
When using the draft/publish functionality in Strapi this setting will make sure that all draft pages are excluded from the sitemap. If you want to have the draft pages in the sitemap anyways you can disable this setting.
required:
NO |type:
bool |default:
true
This setting will add a default /
entry to the sitemap XML when none is present. The /
entry corresponds to the homepage of your website.
required:
NO |type:
bool |default:
true
Config can be changed in the config/plugins.js
file in your Strapi project.
You can overwrite the config like so:
module.exports = ({ env }) => ({
// ...
'sitemap': {
enabled: true,
config: {
autoGenerate: true,
allowedFields: ['id', 'uid'],
excludedTypes: [],
},
},
});
When adding URL bundles to your sitemap XML, and auto generate is set to true, the plugin will utilize the lifecycle methods to regenerate the sitemap on create
, update
and delete
for pages of the URL bundles type. This way your sitemap will always be up-to-date when making content changes.
You might want to disable this setting if you're experiencing performance issues. You could alternatively create a cronjob in which you generate the sitemap XML periodically. Like so:
// Generate the sitemap every 12 hours
'0 */12 * * *': () => {
strapi.plugin('sitemap').service('core').createSitemap();
},
required:
NO |type:
bool |default:
true
When defining a URL pattern you can populate it with dynamic fields. The fields allowed in the pattern are specified by type. By default only the field types id
and uid
are allowed in the pattern, but you can alter this setting to allow more field types in the pattern.
If you are missing a key field type of which you think it should be allowed by default please create an issue and explain why it is needed.
required:
NO |type:
array |default:
['id', 'uid']
This setting is just here for mere convenience. When adding a URL bundle to the sitemap you can specify the type for the bundle. This will show all types in Strapi, however some types should never be it's own page in a website and are therefor excluded in this setting.
All types in this array will not be shown as an option when selecting the type of a URL bundle.
required:
NO |type:
array |default:
['admin::permission', 'admin::role', 'admin::api-token', 'plugin::i18n.locale', 'plugin::users-permissions.permission', 'plugin::users-permissions.role']
Feel free to fork and make a pull request of this plugin. All the input is welcome!
Give a star if this project helped you.
- For general help using Strapi, please refer to the official Strapi documentation.
- You can contact me on the Strapi Discord channel.