@docusaurus/theme-classic 0.0.0-4178 → 0.0.0-4179

package/lib/theme/BlogListPage/index.js

@@ -43,7 +43,7 @@ function BlogListPage(props) {
   } = metadata;
   const isBlogOnlyMode = permalink === '/';
   const title = isBlogOnlyMode ? siteTitle : blogTitle;
-  return <_BlogLayout.default title={title} description={blogDescription} wrapperClassName={_themeCommon.ThemeClassNames.wrapper.blogPages} pageClassName={_themeCommon.ThemeClassNames.page.blogListPage} searchMetadatas={{
+  return <_BlogLayout.default title={title} description={blogDescription} wrapperClassName={_themeCommon.ThemeClassNames.wrapper.blogPages} pageClassName={_themeCommon.ThemeClassNames.page.blogListPage} searchMetadata={{
     // assign unique search tag to exclude this page from search results!
     tag: 'blog_posts_list'
   }} sidebar={sidebar}>

package/lib/theme/BlogTagsListPage/index.js

@@ -27,7 +27,7 @@ function BlogTagsListPage(props) {
     sidebar
   } = props;
   const title = (0, _themeCommon.translateTagsPageTitle)();
-  return <_BlogLayout.default title={title} wrapperClassName={_themeCommon.ThemeClassNames.wrapper.blogPages} pageClassName={_themeCommon.ThemeClassNames.page.blogTagsListPage} searchMetadatas={{
+  return <_BlogLayout.default title={title} wrapperClassName={_themeCommon.ThemeClassNames.wrapper.blogPages} pageClassName={_themeCommon.ThemeClassNames.page.blogTagsListPage} searchMetadata={{
     // assign unique search tag to exclude this page from search results!
     tag: 'blog_tags_list'
   }} sidebar={sidebar}>

package/lib/theme/BlogTagsPostsPage/index.js

@@ -63,7 +63,7 @@ function BlogTagsPostsPage(props) {
     nPosts: blogPostsPlural(count),
     tagName
   });
-  return <_BlogLayout.default title={title} wrapperClassName={_themeCommon.ThemeClassNames.wrapper.blogPages} pageClassName={_themeCommon.ThemeClassNames.page.blogTagPostListPage} searchMetadatas={{
+  return <_BlogLayout.default title={title} wrapperClassName={_themeCommon.ThemeClassNames.wrapper.blogPages} pageClassName={_themeCommon.ThemeClassNames.page.blogTagPostListPage} searchMetadata={{
     // assign unique search tag to exclude this page from search results!
     tag: 'blog_tags_posts'
   }} sidebar={sidebar}>

package/lib/theme/DocPage/index.js

@@ -67,7 +67,7 @@ function DocPageContent({
 
     setHiddenSidebarContainer(value => !value);
   }, [hiddenSidebar]);
-  return <_Layout.default wrapperClassName={_themeCommon.ThemeClassNames.wrapper.docsPages} pageClassName={_themeCommon.ThemeClassNames.page.docsDocPage} searchMetadatas={{
+  return <_Layout.default wrapperClassName={_themeCommon.ThemeClassNames.wrapper.docsPages} pageClassName={_themeCommon.ThemeClassNames.page.docsDocPage} searchMetadata={{
     version,
     tag: (0, _themeCommon.docVersionSearchTag)(pluginId, version)
   }}>

package/lib/theme/DocTagDocListPage/index.js

@@ -64,7 +64,7 @@ function DocTagDocListPage({
     nDocsTagged: nDocsTaggedPlural(tag.docs.length),
     tagName: tag.name
   });
-  return <_Layout.default title={title} wrapperClassName={_themeCommon.ThemeClassNames.wrapper.docsPages} pageClassName={_themeCommon.ThemeClassNames.page.docsTagDocListPage} searchMetadatas={{
+  return <_Layout.default title={title} wrapperClassName={_themeCommon.ThemeClassNames.wrapper.docsPages} pageClassName={_themeCommon.ThemeClassNames.page.docsTagDocListPage} searchMetadata={{
     // assign unique search tag to exclude this page from search results!
     tag: 'doc_tag_doc_list'
   }}>

package/lib/theme/DocTagsListPage/index.js

@@ -25,7 +25,7 @@ function DocTagsListPage({
   tags
 }) {
   const title = (0, _themeCommon.translateTagsPageTitle)();
-  return <_Layout.default title={title} wrapperClassName={_themeCommon.ThemeClassNames.wrapper.docsPages} pageClassName={_themeCommon.ThemeClassNames.page.docsTagsListPage} searchMetadatas={{
+  return <_Layout.default title={title} wrapperClassName={_themeCommon.ThemeClassNames.wrapper.docsPages} pageClassName={_themeCommon.ThemeClassNames.page.docsTagsListPage} searchMetadata={{
     // assign unique search tag to exclude this page from search results!
     tag: 'doc_tags_list'
   }}>

package/lib/theme/LayoutHead/index.js

@@ -13,7 +13,7 @@ var _useDocusaurusContext = _interopRequireDefault(require("@docusaurus/useDocus
 
 var _useBaseUrl = _interopRequireDefault(require("@docusaurus/useBaseUrl"));
 
-var _SearchMetadatas = _interopRequireDefault(require("@theme/SearchMetadatas"));
+var _SearchMetadata = _interopRequireDefault(require("@theme/SearchMetadata"));
 
 var _Seo = _interopRequireDefault(require("@theme/Seo"));
 
@@ -94,7 +94,7 @@ function LayoutHead(props) {
     }
   } = (0, _useDocusaurusContext.default)();
   const {
-    metadatas,
+    metadata,
     image: defaultImage
   } = (0, _themeCommon.useThemeConfig)();
   const {
@@ -102,7 +102,7 @@ function LayoutHead(props) {
     description,
     image,
     keywords,
-    searchMetadatas
+    searchMetadata
   } = props;
   const faviconUrl = (0, _useBaseUrl.default)(favicon);
   const pageTitle = (0, _themeCommon.useTitleFormatter)(title); // See https://github.com/facebook/docusaurus/issues/3317#issuecomment-754661855
@@ -132,15 +132,18 @@ function LayoutHead(props) {
 
       <AlternateLangHeaders />
 
-      <_SearchMetadatas.default tag={_themeCommon.DEFAULT_SEARCH_TAG} locale={currentLocale} {...searchMetadatas} />
+      <_SearchMetadata.default tag={_themeCommon.DEFAULT_SEARCH_TAG} locale={currentLocale} {...searchMetadata} />
 
       <_Head.default // it's important to have an additional <Head> element here,
     // as it allows react-helmet to override values set in previous <Head>
-    // ie we can override default metadatas such as "twitter:card"
+    // ie we can override default metadata such as "twitter:card"
     // In same Head, the same meta would appear twice instead of overriding
     // See react-helmet doc
     >
-        {metadatas.map((metadata, i) => <meta key={`metadata_${i}`} {...metadata} />)}
+        {
+        /* Yes, "metadatum" is the grammatically correct term */
+      }
+        {metadata.map((metadatum, i) => <meta key={`metadata_${i}`} {...metadatum} />)}
       </_Head.default>
     </>;
 }

package/lib/theme/{SearchMetadatas → SearchMetadata}/index.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = SearchMetadatas;
+exports.default = SearchMetadata;
 
 var _react = _interopRequireDefault(require("react"));
 
@@ -20,7 +20,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
 // Note: we don't couple this to Algolia/DocSearch on purpose
 // We may want to support other search engine plugins too
 // Search plugins should swizzle/override this comp to add their behavior
-function SearchMetadatas({
+function SearchMetadata({
   locale,
   version,
   tag

package/lib/types.d.ts

@@ -301,7 +301,7 @@ declare module '@theme/Layout' {
     readonly permalink?: string;
     readonly wrapperClassName?: string;
     readonly pageClassName?: string;
-    readonly searchMetadatas?: {
+    readonly searchMetadata?: {
       readonly version?: string;
       readonly tag?: string;
     };
@@ -320,15 +320,15 @@ declare module '@theme/LayoutHead' {
   export default LayoutHead;
 }
 
-declare module '@theme/SearchMetadatas' {
+declare module '@theme/SearchMetadata' {
   export interface Props {
     readonly locale?: string;
     readonly version?: string;
     readonly tag?: string;
   }
 
-  const SearchMetadatas: (props: Props) => JSX.Element;
-  export default SearchMetadatas;
+  const SearchMetadata: (props: Props) => JSX.Element;
+  export default SearchMetadata;
 }
 
 declare module '@theme/LastUpdated' {

package/lib/validateThemeConfig.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.validateThemeConfig = validateThemeConfig;
-exports.ThemeConfigSchema = void 0;
+exports.ThemeConfigSchema = exports.DEFAULT_CONFIG = void 0;
 
 var _utilsValidation = require("@docusaurus/utils-validation");
 
@@ -36,7 +36,7 @@ const DEFAULT_COLOR_MODE_CONFIG = {
 const DEFAULT_CONFIG = {
   colorMode: DEFAULT_COLOR_MODE_CONFIG,
   docs: DEFAULT_DOCS_CONFIG,
-  metadatas: [],
+  metadata: [],
   prism: {
     additionalLanguages: []
   },
@@ -218,7 +218,10 @@ const ThemeConfigSchema = _utilsValidation.Joi.object({
   colorMode: ColorModeSchema,
   image: _utilsValidation.Joi.string(),
   docs: DocsSchema,
-  metadatas: _utilsValidation.Joi.array().items(HtmlMetadataSchema).default(DEFAULT_CONFIG.metadatas),
+  metadata: _utilsValidation.Joi.array().items(HtmlMetadataSchema).default(DEFAULT_CONFIG.metadata),
+  metadatas: _utilsValidation.Joi.any().forbidden().messages({
+    'any.unknown': 'themeConfig.metadatas has been renamed as themeConfig.metadata. See https://github.com/facebook/docusaurus/pull/5871'
+  }),
   announcementBar: _utilsValidation.Joi.object({
     id: _utilsValidation.Joi.string().default('announcement-bar'),
     content: _utilsValidation.Joi.string().required(),

package/lib-next/theme/BlogListPage/index.js

@@ -25,7 +25,7 @@ function BlogListPage(props) {
       description={blogDescription}
       wrapperClassName={ThemeClassNames.wrapper.blogPages}
       pageClassName={ThemeClassNames.page.blogListPage}
-      searchMetadatas={{
+      searchMetadata={{
         // assign unique search tag to exclude this page from search results!
         tag: 'blog_posts_list',
       }}

package/lib-next/theme/BlogTagsListPage/index.js

@@ -20,7 +20,7 @@ function BlogTagsListPage(props) {
       title={title}
       wrapperClassName={ThemeClassNames.wrapper.blogPages}
       pageClassName={ThemeClassNames.page.blogTagsListPage}
-      searchMetadatas={{
+      searchMetadata={{
         // assign unique search tag to exclude this page from search results!
         tag: 'blog_tags_list',
       }}

package/lib-next/theme/BlogTagsPostsPage/index.js

@@ -50,7 +50,7 @@ export default function BlogTagsPostsPage(props) {
       title={title}
       wrapperClassName={ThemeClassNames.wrapper.blogPages}
       pageClassName={ThemeClassNames.page.blogTagPostListPage}
-      searchMetadatas={{
+      searchMetadata={{
         // assign unique search tag to exclude this page from search results!
         tag: 'blog_tags_posts',
       }}

package/lib-next/theme/DocPage/index.js

@@ -39,7 +39,7 @@ function DocPageContent({currentDocRoute, versionMetadata, children}) {
     <Layout
       wrapperClassName={ThemeClassNames.wrapper.docsPages}
       pageClassName={ThemeClassNames.page.docsDocPage}
-      searchMetadatas={{
+      searchMetadata={{
         version,
         tag: docVersionSearchTag(pluginId, version),
       }}>

package/lib-next/theme/DocTagDocListPage/index.js

@@ -59,7 +59,7 @@ export default function DocTagDocListPage({tag}) {
       title={title}
       wrapperClassName={ThemeClassNames.wrapper.docsPages}
       pageClassName={ThemeClassNames.page.docsTagDocListPage}
-      searchMetadatas={{
+      searchMetadata={{
         // assign unique search tag to exclude this page from search results!
         tag: 'doc_tag_doc_list',
       }}>

package/lib-next/theme/DocTagsListPage/index.js

@@ -19,7 +19,7 @@ function DocTagsListPage({tags}) {
       title={title}
       wrapperClassName={ThemeClassNames.wrapper.docsPages}
       pageClassName={ThemeClassNames.page.docsTagsListPage}
-      searchMetadatas={{
+      searchMetadata={{
         // assign unique search tag to exclude this page from search results!
         tag: 'doc_tags_list',
       }}>

package/lib-next/theme/LayoutHead/index.js

@@ -8,7 +8,7 @@ import React from 'react';
 import Head from '@docusaurus/Head';
 import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
 import useBaseUrl from '@docusaurus/useBaseUrl';
-import SearchMetadatas from '@theme/SearchMetadatas';
+import SearchMetadata from '@theme/SearchMetadata';
 import Seo from '@theme/Seo';
 import {
   DEFAULT_SEARCH_TAG,
@@ -81,8 +81,8 @@ export default function LayoutHead(props) {
     siteConfig: {favicon},
     i18n: {currentLocale, localeConfigs},
   } = useDocusaurusContext();
-  const {metadatas, image: defaultImage} = useThemeConfig();
-  const {title, description, image, keywords, searchMetadatas} = props;
+  const {metadata, image: defaultImage} = useThemeConfig();
+  const {title, description, image, keywords, searchMetadata} = props;
   const faviconUrl = useBaseUrl(favicon);
   const pageTitle = useTitleFormatter(title); // See https://github.com/facebook/docusaurus/issues/3317#issuecomment-754661855
   // const htmlLang = currentLocale.split('-')[0];
@@ -110,20 +110,21 @@ export default function LayoutHead(props) {
 
       <AlternateLangHeaders />
 
-      <SearchMetadatas
+      <SearchMetadata
         tag={DEFAULT_SEARCH_TAG}
         locale={currentLocale}
-        {...searchMetadatas}
+        {...searchMetadata}
       />
 
       <Head // it's important to have an additional <Head> element here,
       // as it allows react-helmet to override values set in previous <Head>
-      // ie we can override default metadatas such as "twitter:card"
+      // ie we can override default metadata such as "twitter:card"
       // In same Head, the same meta would appear twice instead of overriding
       // See react-helmet doc
       >
-        {metadatas.map((metadata, i) => (
-          <meta key={`metadata_${i}`} {...metadata} />
+        {/* Yes, "metadatum" is the grammatically correct term */}
+        {metadata.map((metadatum, i) => (
+          <meta key={`metadata_${i}`} {...metadatum} />
         ))}
       </Head>
     </>

package/lib-next/theme/{SearchMetadatas → SearchMetadata}/index.js

@@ -9,7 +9,7 @@ import Head from '@docusaurus/Head';
 // Note: we don't couple this to Algolia/DocSearch on purpose
 // We may want to support other search engine plugins too
 // Search plugins should swizzle/override this comp to add their behavior
-export default function SearchMetadatas({locale, version, tag}) {
+export default function SearchMetadata({locale, version, tag}) {
   return (
     <Head>
       {locale && <meta name="docusaurus_locale" content={locale} />}

package/lib-next/types.d.ts

@@ -301,7 +301,7 @@ declare module '@theme/Layout' {
     readonly permalink?: string;
     readonly wrapperClassName?: string;
     readonly pageClassName?: string;
-    readonly searchMetadatas?: {
+    readonly searchMetadata?: {
       readonly version?: string;
       readonly tag?: string;
     };
@@ -320,15 +320,15 @@ declare module '@theme/LayoutHead' {
   export default LayoutHead;
 }
 
-declare module '@theme/SearchMetadatas' {
+declare module '@theme/SearchMetadata' {
   export interface Props {
     readonly locale?: string;
     readonly version?: string;
     readonly tag?: string;
   }
 
-  const SearchMetadatas: (props: Props) => JSX.Element;
-  export default SearchMetadatas;
+  const SearchMetadata: (props: Props) => JSX.Element;
+  export default SearchMetadata;
 }
 
 declare module '@theme/LastUpdated' {

package/lib-next/validateThemeConfig.js

@@ -27,7 +27,7 @@ const DEFAULT_COLOR_MODE_CONFIG = {
 const DEFAULT_CONFIG = {
   colorMode: DEFAULT_COLOR_MODE_CONFIG,
   docs: DEFAULT_DOCS_CONFIG,
-  metadatas: [],
+  metadata: [],
   prism: {
     additionalLanguages: [],
   },
@@ -41,7 +41,6 @@ const DEFAULT_CONFIG = {
     maxHeadingLevel: 3,
   },
 };
-exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
 const NavbarItemPosition = Joi.string().equal('left', 'right').default('left');
 const NavbarItemBaseSchema = Joi.object({
   label: Joi.string(),
@@ -242,9 +241,13 @@ const ThemeConfigSchema = Joi.object({
   colorMode: ColorModeSchema,
   image: Joi.string(),
   docs: DocsSchema,
-  metadatas: Joi.array()
+  metadata: Joi.array()
     .items(HtmlMetadataSchema)
-    .default(DEFAULT_CONFIG.metadatas),
+    .default(DEFAULT_CONFIG.metadata),
+  metadatas: Joi.any().forbidden().messages({
+    'any.unknown':
+      'themeConfig.metadatas has been renamed as themeConfig.metadata. See https://github.com/facebook/docusaurus/pull/5871',
+  }),
   announcementBar: Joi.object({
     id: Joi.string().default('announcement-bar'),
     content: Joi.string().required(),
@@ -335,7 +338,7 @@ const ThemeConfigSchema = Joi.object({
       .default(DEFAULT_CONFIG.tableOfContents.maxHeadingLevel),
   }).default(DEFAULT_CONFIG.tableOfContents),
 });
-export {ThemeConfigSchema};
+export {DEFAULT_CONFIG, ThemeConfigSchema};
 export function validateThemeConfig({validate, themeConfig}) {
   return validate(ThemeConfigSchema, themeConfig);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/theme-classic",
-  "version": "0.0.0-4178",
+  "version": "0.0.0-4179",
   "description": "Classic theme for Docusaurus",
   "main": "lib/index.js",
   "types": "src/types.d.ts",
@@ -23,15 +23,15 @@
     "update-code-translations": "node -e 'require(\"./update-code-translations.js\").run()'"
   },
   "dependencies": {
-    "@docusaurus/core": "0.0.0-4178",
-    "@docusaurus/plugin-content-blog": "0.0.0-4178",
-    "@docusaurus/plugin-content-docs": "0.0.0-4178",
-    "@docusaurus/plugin-content-pages": "0.0.0-4178",
-    "@docusaurus/theme-common": "0.0.0-4178",
-    "@docusaurus/types": "0.0.0-4178",
-    "@docusaurus/utils": "0.0.0-4178",
-    "@docusaurus/utils-common": "0.0.0-4178",
-    "@docusaurus/utils-validation": "0.0.0-4178",
+    "@docusaurus/core": "0.0.0-4179",
+    "@docusaurus/plugin-content-blog": "0.0.0-4179",
+    "@docusaurus/plugin-content-docs": "0.0.0-4179",
+    "@docusaurus/plugin-content-pages": "0.0.0-4179",
+    "@docusaurus/theme-common": "0.0.0-4179",
+    "@docusaurus/types": "0.0.0-4179",
+    "@docusaurus/utils": "0.0.0-4179",
+    "@docusaurus/utils-common": "0.0.0-4179",
+    "@docusaurus/utils-validation": "0.0.0-4179",
     "@mdx-js/mdx": "^1.6.21",
     "@mdx-js/react": "^1.6.21",
     "chalk": "^4.1.2",
@@ -50,7 +50,7 @@
     "rtlcss": "^3.3.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "0.0.0-4178",
+    "@docusaurus/module-type-aliases": "0.0.0-4179",
     "@types/mdx-js__react": "^1.5.4",
     "@types/parse-numeric-range": "^0.0.1",
     "@types/rtlcss": "^3.1.1",
@@ -64,5 +64,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "004b1498ee184dd7a166fb58890ab62571ad61d9"
+  "gitHead": "d61c493d9799b974fb8987530448f46642451363"
 }

package/src/theme/BlogListPage/index.tsx

@@ -29,7 +29,7 @@ function BlogListPage(props: Props): JSX.Element {
       description={blogDescription}
       wrapperClassName={ThemeClassNames.wrapper.blogPages}
       pageClassName={ThemeClassNames.page.blogListPage}
-      searchMetadatas={{
+      searchMetadata={{
         // assign unique search tag to exclude this page from search results!
         tag: 'blog_posts_list',
       }}

package/src/theme/BlogTagsListPage/index.tsx

@@ -23,7 +23,7 @@ function BlogTagsListPage(props: Props): JSX.Element {
       title={title}
       wrapperClassName={ThemeClassNames.wrapper.blogPages}
       pageClassName={ThemeClassNames.page.blogTagsListPage}
-      searchMetadatas={{
+      searchMetadata={{
         // assign unique search tag to exclude this page from search results!
         tag: 'blog_tags_list',
       }}

package/src/theme/BlogTagsPostsPage/index.tsx

@@ -50,7 +50,7 @@ export default function BlogTagsPostsPage(props: Props): JSX.Element {
       title={title}
       wrapperClassName={ThemeClassNames.wrapper.blogPages}
       pageClassName={ThemeClassNames.page.blogTagPostListPage}
-      searchMetadatas={{
+      searchMetadata={{
         // assign unique search tag to exclude this page from search results!
         tag: 'blog_tags_posts',
       }}

package/src/theme/DocPage/index.tsx

@@ -58,7 +58,7 @@ function DocPageContent({
     <Layout
       wrapperClassName={ThemeClassNames.wrapper.docsPages}
       pageClassName={ThemeClassNames.page.docsDocPage}
-      searchMetadatas={{
+      searchMetadata={{
         version,
         tag: docVersionSearchTag(pluginId, version),
       }}>

package/src/theme/DocTagDocListPage/index.tsx

@@ -59,7 +59,7 @@ export default function DocTagDocListPage({tag}: Props): JSX.Element {
       title={title}
       wrapperClassName={ThemeClassNames.wrapper.docsPages}
       pageClassName={ThemeClassNames.page.docsTagDocListPage}
-      searchMetadatas={{
+      searchMetadata={{
         // assign unique search tag to exclude this page from search results!
         tag: 'doc_tag_doc_list',
       }}>

package/src/theme/DocTagsListPage/index.tsx

@@ -22,7 +22,7 @@ function DocTagsListPage({tags}: Props): JSX.Element {
       title={title}
       wrapperClassName={ThemeClassNames.wrapper.docsPages}
       pageClassName={ThemeClassNames.page.docsTagsListPage}
-      searchMetadatas={{
+      searchMetadata={{
         // assign unique search tag to exclude this page from search results!
         tag: 'doc_tags_list',
       }}>

package/src/theme/LayoutHead/index.tsx

@@ -10,7 +10,7 @@ import Head from '@docusaurus/Head';
 import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
 import useBaseUrl from '@docusaurus/useBaseUrl';
 import type {Props} from '@theme/Layout';
-import SearchMetadatas from '@theme/SearchMetadatas';
+import SearchMetadata from '@theme/SearchMetadata';
 import Seo from '@theme/Seo';
 import {
   DEFAULT_SEARCH_TAG,
@@ -87,8 +87,8 @@ export default function LayoutHead(props: Props): JSX.Element {
     siteConfig: {favicon},
     i18n: {currentLocale, localeConfigs},
   } = useDocusaurusContext();
-  const {metadatas, image: defaultImage} = useThemeConfig();
-  const {title, description, image, keywords, searchMetadatas} = props;
+  const {metadata, image: defaultImage} = useThemeConfig();
+  const {title, description, image, keywords, searchMetadata} = props;
   const faviconUrl = useBaseUrl(favicon);
   const pageTitle = useTitleFormatter(title);
 
@@ -117,21 +117,22 @@ export default function LayoutHead(props: Props): JSX.Element {
 
       <AlternateLangHeaders />
 
-      <SearchMetadatas
+      <SearchMetadata
         tag={DEFAULT_SEARCH_TAG}
         locale={currentLocale}
-        {...searchMetadatas}
+        {...searchMetadata}
       />
 
       <Head
       // it's important to have an additional <Head> element here,
       // as it allows react-helmet to override values set in previous <Head>
-      // ie we can override default metadatas such as "twitter:card"
+      // ie we can override default metadata such as "twitter:card"
       // In same Head, the same meta would appear twice instead of overriding
       // See react-helmet doc
       >
-        {metadatas.map((metadata, i) => (
-          <meta key={`metadata_${i}`} {...metadata} />
+        {/* Yes, "metadatum" is the grammatically correct term */}
+        {metadata.map((metadatum, i) => (
+          <meta key={`metadata_${i}`} {...metadatum} />
         ))}
       </Head>
     </>

package/src/theme/{SearchMetadatas → SearchMetadata}/index.tsx

@@ -8,12 +8,12 @@
 import React from 'react';
 
 import Head from '@docusaurus/Head';
-import type {Props} from '@theme/SearchMetadatas';
+import type {Props} from '@theme/SearchMetadata';
 
 // Note: we don't couple this to Algolia/DocSearch on purpose
 // We may want to support other search engine plugins too
 // Search plugins should swizzle/override this comp to add their behavior
-export default function SearchMetadatas({
+export default function SearchMetadata({
   locale,
   version,
   tag,

package/src/types.d.ts

@@ -301,7 +301,7 @@ declare module '@theme/Layout' {
     readonly permalink?: string;
     readonly wrapperClassName?: string;
     readonly pageClassName?: string;
-    readonly searchMetadatas?: {
+    readonly searchMetadata?: {
       readonly version?: string;
       readonly tag?: string;
     };
@@ -320,15 +320,15 @@ declare module '@theme/LayoutHead' {
   export default LayoutHead;
 }
 
-declare module '@theme/SearchMetadatas' {
+declare module '@theme/SearchMetadata' {
   export interface Props {
     readonly locale?: string;
     readonly version?: string;
     readonly tag?: string;
   }
 
-  const SearchMetadatas: (props: Props) => JSX.Element;
-  export default SearchMetadatas;
+  const SearchMetadata: (props: Props) => JSX.Element;
+  export default SearchMetadata;
 }
 
 declare module '@theme/LastUpdated' {

package/src/validateThemeConfig.ts

@@ -32,7 +32,7 @@ const DEFAULT_COLOR_MODE_CONFIG = {
 const DEFAULT_CONFIG = {
   colorMode: DEFAULT_COLOR_MODE_CONFIG,
   docs: DEFAULT_DOCS_CONFIG,
-  metadatas: [],
+  metadata: [],
   prism: {
     additionalLanguages: [],
   },
@@ -46,7 +46,6 @@ const DEFAULT_CONFIG = {
     maxHeadingLevel: 3,
   },
 };
-exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
 
 const NavbarItemPosition = Joi.string().equal('left', 'right').default('left');
 
@@ -264,9 +263,13 @@ const ThemeConfigSchema = Joi.object({
   colorMode: ColorModeSchema,
   image: Joi.string(),
   docs: DocsSchema,
-  metadatas: Joi.array()
+  metadata: Joi.array()
     .items(HtmlMetadataSchema)
-    .default(DEFAULT_CONFIG.metadatas),
+    .default(DEFAULT_CONFIG.metadata),
+  metadatas: Joi.any().forbidden().messages({
+    'any.unknown':
+      'themeConfig.metadatas has been renamed as themeConfig.metadata. See https://github.com/facebook/docusaurus/pull/5871',
+  }),
   announcementBar: Joi.object({
     id: Joi.string().default('announcement-bar'),
     content: Joi.string().required(),
@@ -358,7 +361,7 @@ const ThemeConfigSchema = Joi.object({
   }).default(DEFAULT_CONFIG.tableOfContents),
 });
 
-export {ThemeConfigSchema};
+export {DEFAULT_CONFIG, ThemeConfigSchema};
 
 export function validateThemeConfig({
   validate,