VuePress EcosystemVuePress Ecosystem
  • Theme Guidelines
  • theme-default
  • Hope Theme
  • Plume Theme
  • Reco Theme
  • Feature Plugins
  • Markdown Plugins
  • Search Plugins
  • Blog Plugins
  • PWA Plugins
  • Analytics Plugins
  • SEO Plugins
  • Development Plugins
  • Tool Plugins
  • AI Plugins
  • @vuepress/helper
  • English
  • 简体中文
GitHub
  • Theme Guidelines
  • theme-default
  • Hope Theme
  • Plume Theme
  • Reco Theme
  • Feature Plugins
  • Markdown Plugins
  • Search Plugins
  • Blog Plugins
  • PWA Plugins
  • Analytics Plugins
  • SEO Plugins
  • Development Plugins
  • Tool Plugins
  • AI Plugins
  • @vuepress/helper
  • English
  • 简体中文
GitHub
  • Theme Guidelines
  • Default Theme
    • Config
    • Plugins Config
    • Locale Config
    • Frontmatter
    • Built-in Components
    • Markdown
    • Styles
    • Extending
  • Hope Theme
  • Plume Theme
  • Reco Theme

Locale Config

These options configure locale-related texts.

If your site is served in a different language besides English, you should set these options per locale to provide translations.

Options

repoLabelstring

Specify the repository label of your project.

This will be used as the text of the repository link, which will be displayed as the last item of the navbar.

If you don't set this option explicitly, it will be automatically inferred from the repo option.

selectLanguageTextstring

Specify the text of the select language menu.

The select language menu will appear next to the repository button in the navbar when you set multiple locales in your site config.

selectLanguageAriaLabelstring

Specify the aria-label attribute of the select language menu.

This is mainly for a11y purpose.

selectLanguageNamestring
Default'English'

Specify the name of the language of a locale.

This option will only take effect inside the locales of your theme config. It will be used as the language name of the locale, which will be displayed in the select language menu.

.vuepress/config.ts
export default {
  locales: {
    '/': {
      lang: 'en-US',
    },
    '/zh/': {
      lang: 'zh-CN',
    },
  },
  theme: defaultTheme({
    locales: {
      '/': {
        selectLanguageName: 'English',
      },
      '/zh/': {
        selectLanguageName: '简体中文',
      },
    },
  }),
}
navbarLabelstring | null

Specify the aria-label value for main navigation in navbar.

pageNavbarLabelstring | null

Specify the aria-label value for next/previous page navigation.

editLinkTextstring
Default'Edit this page'

Specify the text of the edit this page link.

lastUpdatedTextstring
Default'Last Updated'

Specify the text of the last updated timestamp label.

contributorsTextstring
Default'Contributors'

Specify the text of the contributors list label.

tipstring
Default'Tips'

Specify the default title of the tip hint container.

warningstring
Default'Warning'

Specify the default title of the warning hint container.

dangerstring
Default'Caution'

Specify the default title of the danger hint container.

importantstring
Default'Important'

Specify the default title of the important hint container.

notestring
Default'Note'

Specify the default title of the note hint container.

notFoundstring[]
Default['There's nothing here.', 'How did we get here?', 'That's a Four-Oh-Four.', 'Looks like we've got some broken links.']

Specify the messages of the 404 page.

The message will be randomly picked from the array when users enter the 404 page.

backToHomestring
Default'Take me home'

Specify the text of the back to home link in the 404 page.

toggleColorModestring
Default'toggle color mode'

Title text for the color mode toggle button.

This is mainly for a11y purpose.

See also: colorModeSwitch

toggleSidebarstring
Default'toggle sidebar'

Title text for sidebar toggle button.

This is mainly for a11y purpose.

prevstring | false
Default'Prev'

Text for the previous page navigation button.

Set to false to disable the previous page navigation button.

nextstring | false
Default'Next'

Text for the next page navigation button.

Set to false to disable the next page navigation button.

Edit this page on GitHub
Last Updated: 9/28/26, 4:40 AM
Contributors: Mister-Hope, 张怀文
Prev
Plugins Config
Next
Frontmatter