Skip to main content
Version: 2.0.0-alpha.74

πŸ“¦ plugin-content-pages

The default pages plugin for Docusaurus. The classic template ships with this plugin with default configurations. This plugin provides creating pages functionality.


npm install --save @docusaurus/plugin-content-pages

If you have installed @docusaurus/preset-classic, you don't need to install it as a dependency. You can also configure it through the classic preset options instead of doing it like below.


module.exports = {
plugins: [
* Path to data on filesystem
* relative to site dir
* components in this directory will be automatically converted to pages
path: 'src/pages',
* URL route for the page section of your site
* do not include trailing slash
routeBasePath: '',
include: ['**/*.{js,jsx,ts,tsx,md,mdx}'],
* No Route will be created for matching files
exclude: [
* Theme component used by markdown pages.
mdxPageComponent: '@theme/MDXPage',
* Remark and Rehype plugins passed to MDX
remarkPlugins: [],
rehypePlugins: [],
* Custom Remark and Rehype plugins passed to MDX before
* the default Docusaurus Remark and Rehype plugins.
beforeDefaultRemarkPlugins: [],
beforeDefaultRehypePlugins: [],


Read the i18n introduction first.

Translation files location#

  • Base path: website/i18n/<locale>/docusaurus-plugin-content-pages
  • Multi-instance path: website/i18n/<locale>/docusaurus-plugin-content-pages-<pluginId>
  • JSON files: extracted with docusaurus write-translations
  • Markdown files: website/i18n/<locale>/docusaurus-plugin-content-pages

Example file-system structure#

β”‚ # translations for website/src/pages
Last updated on by SΓ©bastien Lorber