diff --git a/package.json b/package.json
index 2ba6e75b2dea..73981fd7c6ca 100644
--- a/package.json
+++ b/package.json
@@ -60,7 +60,8 @@
     "watch": "yarn lerna run --parallel watch",
     "clear": "(yarn workspace website clear || echo 'Failure while running docusaurus clear') && yarn rimraf test-website && yarn rimraf test-website-in-workspace && yarn lerna exec --ignore docusaurus yarn rimraf lib",
     "test:baseUrl": "yarn build:website:baseUrl && yarn serve:website:baseUrl",
-    "lock:update": "npx --yes yarn-deduplicate"
+    "lock:update": "npx --yes yarn-deduplicate",
+    "update-translations": "yarn workspace @docusaurus/theme-translations update"
   },
   "dependencies": {
     "unified": "^10.1.2"
diff --git a/packages/docusaurus-theme-classic/src/getSwizzleConfig.ts b/packages/docusaurus-theme-classic/src/getSwizzleConfig.ts
index 4c5ae45d506d..f3761d8857cb 100644
--- a/packages/docusaurus-theme-classic/src/getSwizzleConfig.ts
+++ b/packages/docusaurus-theme-classic/src/getSwizzleConfig.ts
@@ -19,13 +19,6 @@ export default function getSwizzleConfig(): SwizzleConfig {
         },
         description: 'The folder containing all admonition icons',
       },
-      'Admonition/Icon/Caution': {
-        actions: {
-          eject: 'safe',
-          wrap: 'safe',
-        },
-        description: 'The admonition caution icon',
-      },
       'Admonition/Icon/Danger': {
         actions: {
           eject: 'safe',
@@ -54,6 +47,13 @@ export default function getSwizzleConfig(): SwizzleConfig {
         },
         description: 'The admonition tip icon',
       },
+      'Admonition/Icon/Warning': {
+        actions: {
+          eject: 'safe',
+          wrap: 'safe',
+        },
+        description: 'The admonition warning icon',
+      },
       'Admonition/Layout': {
         actions: {
           eject: 'safe',
@@ -110,6 +110,14 @@ export default function getSwizzleConfig(): SwizzleConfig {
         description:
           'The component responsible for rendering a :::tip admonition type',
       },
+      'Admonition/Type/Warning': {
+        actions: {
+          eject: 'safe',
+          wrap: 'safe',
+        },
+        description:
+          'The component responsible for rendering a :::warning admonition type',
+      },
       'Admonition/Types': {
         actions: {
           eject: 'safe',
diff --git a/packages/docusaurus-theme-classic/src/theme-classic.d.ts b/packages/docusaurus-theme-classic/src/theme-classic.d.ts
index e1f898775109..77a5cf283c21 100644
--- a/packages/docusaurus-theme-classic/src/theme-classic.d.ts
+++ b/packages/docusaurus-theme-classic/src/theme-classic.d.ts
@@ -74,6 +74,8 @@ declare module '@theme/Admonition/Type/Tip' {
   export default function AdmonitionTypeTip(props: Props): JSX.Element;
 }
 
+// TODO remove before v4: Caution replaced by Warning
+// see https://github.com/facebook/docusaurus/issues/7558
 declare module '@theme/Admonition/Type/Caution' {
   import type {Props as AdmonitionProps} from '@theme/Admonition';
 
@@ -81,6 +83,13 @@ declare module '@theme/Admonition/Type/Caution' {
   export default function AdmonitionTypeCaution(props: Props): JSX.Element;
 }
 
+declare module '@theme/Admonition/Type/Warning' {
+  import type {Props as AdmonitionProps} from '@theme/Admonition';
+
+  export interface Props extends AdmonitionProps {}
+  export default function AdmonitionTypeWarning(props: Props): JSX.Element;
+}
+
 declare module '@theme/Admonition/Type/Danger' {
   import type {Props as AdmonitionProps} from '@theme/Admonition';
 
@@ -128,12 +137,12 @@ declare module '@theme/Admonition/Icon/Tip' {
   export default function AdmonitionIconTip(props: Props): JSX.Element;
 }
 
-declare module '@theme/Admonition/Icon/Caution' {
+declare module '@theme/Admonition/Icon/Warning' {
   import type {ComponentProps} from 'react';
 
   export interface Props extends ComponentProps<'svg'> {}
 
-  export default function AdmonitionIconCaution(props: Props): JSX.Element;
+  export default function AdmonitionIconWarning(props: Props): JSX.Element;
 }
 
 declare module '@theme/Admonition/Icon/Danger' {
diff --git a/packages/docusaurus-theme-classic/src/theme/Admonition/Icon/Caution.tsx b/packages/docusaurus-theme-classic/src/theme/Admonition/Icon/Warning.tsx
similarity index 91%
rename from packages/docusaurus-theme-classic/src/theme/Admonition/Icon/Caution.tsx
rename to packages/docusaurus-theme-classic/src/theme/Admonition/Icon/Warning.tsx
index ae47231d1f91..ae56e93a6091 100644
--- a/packages/docusaurus-theme-classic/src/theme/Admonition/Icon/Caution.tsx
+++ b/packages/docusaurus-theme-classic/src/theme/Admonition/Icon/Warning.tsx
@@ -6,7 +6,7 @@
  */
 
 import React from 'react';
-import type {Props} from '@theme/Admonition/Icon/Caution';
+import type {Props} from '@theme/Admonition/Icon/Warning';
 
 export default function AdmonitionIconCaution(props: Props): JSX.Element {
   return (
diff --git a/packages/docusaurus-theme-classic/src/theme/Admonition/Type/Caution.tsx b/packages/docusaurus-theme-classic/src/theme/Admonition/Type/Caution.tsx
index b929f635407c..35e6a19e81fe 100644
--- a/packages/docusaurus-theme-classic/src/theme/Admonition/Type/Caution.tsx
+++ b/packages/docusaurus-theme-classic/src/theme/Admonition/Type/Caution.tsx
@@ -10,12 +10,12 @@ import clsx from 'clsx';
 import Translate from '@docusaurus/Translate';
 import type {Props} from '@theme/Admonition/Type/Caution';
 import AdmonitionLayout from '@theme/Admonition/Layout';
-import IconCaution from '@theme/Admonition/Icon/Caution';
+import IconWarning from '@theme/Admonition/Icon/Warning';
 
 const infimaClassName = 'alert alert--warning';
 
 const defaultProps = {
-  icon: <IconCaution />,
+  icon: <IconWarning />,
   title: (
     <Translate
       id="theme.admonition.caution"
@@ -25,6 +25,8 @@ const defaultProps = {
   ),
 };
 
+// TODO remove before v4: Caution replaced by Warning
+// see https://github.com/facebook/docusaurus/issues/7558
 export default function AdmonitionTypeCaution(props: Props): JSX.Element {
   return (
     <AdmonitionLayout
diff --git a/packages/docusaurus-theme-classic/src/theme/Admonition/Type/Warning.tsx b/packages/docusaurus-theme-classic/src/theme/Admonition/Type/Warning.tsx
new file mode 100644
index 000000000000..7619ecad933e
--- /dev/null
+++ b/packages/docusaurus-theme-classic/src/theme/Admonition/Type/Warning.tsx
@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import React from 'react';
+import clsx from 'clsx';
+import Translate from '@docusaurus/Translate';
+import type {Props} from '@theme/Admonition/Type/Warning';
+import AdmonitionLayout from '@theme/Admonition/Layout';
+import IconWarning from '@theme/Admonition/Icon/Warning';
+
+const infimaClassName = 'alert alert--warning';
+
+const defaultProps = {
+  icon: <IconWarning />,
+  title: (
+    <Translate
+      id="theme.admonition.warning"
+      description="The default label used for the Warning admonition (:::warning)">
+      warning
+    </Translate>
+  ),
+};
+
+export default function AdmonitionTypeWarning(props: Props): JSX.Element {
+  return (
+    <AdmonitionLayout
+      {...defaultProps}
+      {...props}
+      className={clsx(infimaClassName, props.className)}>
+      {props.children}
+    </AdmonitionLayout>
+  );
+}
diff --git a/packages/docusaurus-theme-classic/src/theme/Admonition/Types.tsx b/packages/docusaurus-theme-classic/src/theme/Admonition/Types.tsx
index ac36bfe20ba9..654063cf861e 100644
--- a/packages/docusaurus-theme-classic/src/theme/Admonition/Types.tsx
+++ b/packages/docusaurus-theme-classic/src/theme/Admonition/Types.tsx
@@ -9,15 +9,16 @@ import React from 'react';
 import AdmonitionTypeNote from '@theme/Admonition/Type/Note';
 import AdmonitionTypeTip from '@theme/Admonition/Type/Tip';
 import AdmonitionTypeInfo from '@theme/Admonition/Type/Info';
-import AdmonitionTypeCaution from '@theme/Admonition/Type/Caution';
+import AdmonitionTypeWarning from '@theme/Admonition/Type/Warning';
 import AdmonitionTypeDanger from '@theme/Admonition/Type/Danger';
+import AdmonitionTypeCaution from '@theme/Admonition/Type/Caution';
 import type AdmonitionTypes from '@theme/Admonition/Types';
 
 const admonitionTypes: typeof AdmonitionTypes = {
   note: AdmonitionTypeNote,
   tip: AdmonitionTypeTip,
   info: AdmonitionTypeInfo,
-  caution: AdmonitionTypeCaution,
+  warning: AdmonitionTypeWarning,
   danger: AdmonitionTypeDanger,
 };
 
@@ -28,8 +29,7 @@ const admonitionAliases: typeof AdmonitionTypes = {
   secondary: (props) => <AdmonitionTypeNote title="secondary" {...props} />,
   important: (props) => <AdmonitionTypeInfo title="important" {...props} />,
   success: (props) => <AdmonitionTypeTip title="success" {...props} />,
-  // TODO bad legacy mapping, warning is usually yellow, not red...
-  warning: (props) => <AdmonitionTypeDanger title="warning" {...props} />,
+  caution: AdmonitionTypeCaution,
 };
 
 export default {
diff --git a/packages/docusaurus-theme-translations/locales/ar/theme-common.json b/packages/docusaurus-theme-translations/locales/ar/theme-common.json
index a31519a79a42..2af8e40a5b39 100644
--- a/packages/docusaurus-theme-translations/locales/ar/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/ar/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "معلومات",
   "theme.admonition.note": "ملاحظة",
   "theme.admonition.tip": "تلميح",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "أرشيف",
   "theme.blog.archive.title": "أرشيف",
   "theme.blog.paginator.navAriaLabel": "التنقل في صفحة قائمة المدونة",
diff --git a/packages/docusaurus-theme-translations/locales/base/theme-common.json b/packages/docusaurus-theme-translations/locales/base/theme-common.json
index cbdb98d59db6..705b1c120bae 100644
--- a/packages/docusaurus-theme-translations/locales/base/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/base/theme-common.json
@@ -12,8 +12,9 @@
   "theme.CodeBlock.wordWrapToggle": "Toggle word wrap",
   "theme.CodeBlock.wordWrapToggle___DESCRIPTION": "The title attribute for toggle word wrapping button of code block lines",
   "theme.DocSidebarItem.collapseCategoryAriaLabel": "Collapse sidebar category '{label}'",
+  "theme.DocSidebarItem.collapseCategoryAriaLabel___DESCRIPTION": "The ARIA label to collapse the sidebar category",
   "theme.DocSidebarItem.expandCategoryAriaLabel": "Expand sidebar category '{label}'",
-  "theme.DocSidebarItem.toggleCollapsedCategoryAriaLabel___DESCRIPTION": "The ARIA label to toggle the collapsible sidebar category",
+  "theme.DocSidebarItem.expandCategoryAriaLabel___DESCRIPTION": "The ARIA label to expand the sidebar category",
   "theme.ErrorPageContent.title": "This page crashed.",
   "theme.ErrorPageContent.title___DESCRIPTION": "The title of the fallback page when the page crashed",
   "theme.ErrorPageContent.tryAgain": "Try again",
@@ -38,6 +39,8 @@
   "theme.admonition.note___DESCRIPTION": "The default label used for the Note admonition (:::note)",
   "theme.admonition.tip": "tip",
   "theme.admonition.tip___DESCRIPTION": "The default label used for the Tip admonition (:::tip)",
+  "theme.admonition.warning": "warning",
+  "theme.admonition.warning___DESCRIPTION": "The default label used for the Warning admonition (:::warning)",
   "theme.blog.archive.description": "Archive",
   "theme.blog.archive.description___DESCRIPTION": "The page & hero description of the blog archive page",
   "theme.blog.archive.title": "Archive",
diff --git a/packages/docusaurus-theme-translations/locales/bn/theme-common.json b/packages/docusaurus-theme-translations/locales/bn/theme-common.json
index 8dc7fa769818..05fdee9f7951 100644
--- a/packages/docusaurus-theme-translations/locales/bn/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/bn/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archive",
   "theme.blog.archive.title": "Archive",
   "theme.blog.paginator.navAriaLabel": "ব্লগ তালিকা পেজ নেভিগেশন",
diff --git a/packages/docusaurus-theme-translations/locales/cs/theme-common.json b/packages/docusaurus-theme-translations/locales/cs/theme-common.json
index 9753998f7bcc..aa2bbb1b974d 100644
--- a/packages/docusaurus-theme-translations/locales/cs/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/cs/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archive",
   "theme.blog.archive.title": "Archive",
   "theme.blog.paginator.navAriaLabel": "Stránkování článků na blogu",
diff --git a/packages/docusaurus-theme-translations/locales/da/theme-common.json b/packages/docusaurus-theme-translations/locales/da/theme-common.json
index ea9abfac5331..1e8e0058ca18 100644
--- a/packages/docusaurus-theme-translations/locales/da/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/da/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archive",
   "theme.blog.archive.title": "Archive",
   "theme.blog.paginator.navAriaLabel": "Blogoversigt navigation",
diff --git a/packages/docusaurus-theme-translations/locales/de/theme-common.json b/packages/docusaurus-theme-translations/locales/de/theme-common.json
index ebf4d7afb98a..8d2a75fe923e 100644
--- a/packages/docusaurus-theme-translations/locales/de/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/de/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archiv",
   "theme.blog.archive.title": "Archiv",
   "theme.blog.paginator.navAriaLabel": "Navigation der Blog-Listenseite",
diff --git a/packages/docusaurus-theme-translations/locales/es/theme-common.json b/packages/docusaurus-theme-translations/locales/es/theme-common.json
index a7fef14bc041..db97f321ccf7 100644
--- a/packages/docusaurus-theme-translations/locales/es/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/es/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archivo",
   "theme.blog.archive.title": "Archivo",
   "theme.blog.paginator.navAriaLabel": "Navegación por la página de la lista de blogs ",
diff --git a/packages/docusaurus-theme-translations/locales/fa/theme-common.json b/packages/docusaurus-theme-translations/locales/fa/theme-common.json
index bf6b80e775df..fa06a69b15e1 100644
--- a/packages/docusaurus-theme-translations/locales/fa/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/fa/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "آرشیو",
   "theme.blog.archive.title": "آرشیو",
   "theme.blog.paginator.navAriaLabel": "کنترل لیست مطالب وبلاگ",
diff --git a/packages/docusaurus-theme-translations/locales/fil/theme-common.json b/packages/docusaurus-theme-translations/locales/fil/theme-common.json
index 9d8ba250ef63..06175cd03ede 100644
--- a/packages/docusaurus-theme-translations/locales/fil/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/fil/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archive",
   "theme.blog.archive.title": "Archive",
   "theme.blog.paginator.navAriaLabel": "Nabegasyón para sa pahina na listahan ng blog",
diff --git a/packages/docusaurus-theme-translations/locales/fr/theme-common.json b/packages/docusaurus-theme-translations/locales/fr/theme-common.json
index cfe6a27eebf4..0d80e4a7a9a8 100644
--- a/packages/docusaurus-theme-translations/locales/fr/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/fr/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "remarque",
   "theme.admonition.tip": "astuce",
+  "theme.admonition.warning": "attention",
   "theme.blog.archive.description": "Archive",
   "theme.blog.archive.title": "Archive",
   "theme.blog.paginator.navAriaLabel": "Pagination de la liste des articles du blog",
diff --git a/packages/docusaurus-theme-translations/locales/he/theme-common.json b/packages/docusaurus-theme-translations/locales/he/theme-common.json
index 57817242be79..00badf24955a 100644
--- a/packages/docusaurus-theme-translations/locales/he/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/he/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archive",
   "theme.blog.archive.title": "Archive",
   "theme.blog.paginator.navAriaLabel": "רשימת דפי הבלוג",
diff --git a/packages/docusaurus-theme-translations/locales/hi/theme-common.json b/packages/docusaurus-theme-translations/locales/hi/theme-common.json
index dfd89f31e372..994c34e08dc5 100644
--- a/packages/docusaurus-theme-translations/locales/hi/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/hi/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archive",
   "theme.blog.archive.title": "Archive",
   "theme.blog.paginator.navAriaLabel": "ब्लॉग सूची पेज नेविगेशन",
diff --git a/packages/docusaurus-theme-translations/locales/hu/theme-common.json b/packages/docusaurus-theme-translations/locales/hu/theme-common.json
index 0cbd699d1d5e..8252f9db0c5a 100644
--- a/packages/docusaurus-theme-translations/locales/hu/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/hu/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "információ",
   "theme.admonition.note": "megjegyzés",
   "theme.admonition.tip": "tanács",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archívum",
   "theme.blog.archive.title": "Archívum",
   "theme.blog.paginator.navAriaLabel": "Bloglista oldalának navigációja",
@@ -67,5 +68,7 @@
   "theme.navbar.mobileVersionsDropdown.label": "Verziók",
   "theme.tags.tagsListLabel": "Címkék:",
   "theme.tags.tagsPageLink": "Összes címke megtekintése",
-  "theme.tags.tagsPageTitle": "Címkék"
+  "theme.tags.tagsPageTitle": "Címkék",
+  "theme.unlistedContent.message": "This page is unlisted. Search engines will not index it, and only users having a direct link can access it.",
+  "theme.unlistedContent.title": "Unlisted page"
 }
diff --git a/packages/docusaurus-theme-translations/locales/hu/theme-search-algolia.json b/packages/docusaurus-theme-translations/locales/hu/theme-search-algolia.json
index 93f5dd7ef34a..0bf7ebca2426 100644
--- a/packages/docusaurus-theme-translations/locales/hu/theme-search-algolia.json
+++ b/packages/docusaurus-theme-translations/locales/hu/theme-search-algolia.json
@@ -24,7 +24,6 @@
   "theme.SearchModal.startScreen.removeFavoriteSearchButtonTitle": "Törölje ezt a keresést a kedvencekből",
   "theme.SearchModal.startScreen.removeRecentSearchButtonTitle": "Törölje ezt a keresést az előzményekből",
   "theme.SearchModal.startScreen.saveRecentSearchButtonTitle": "Mentsük el ezt a keresést",
-  "theme.SearchPage.saveRecentSearchButtonTitle": "Mentse ezt a keresést",
   "theme.SearchPage.algoliaLabel": "Keresés az Algolia segítségével",
   "theme.SearchPage.documentsFound.plurals": "Egy dokumentum|{count} dokumentumok",
   "theme.SearchPage.emptyResultsTitle": "Keresés a webhelyen",
@@ -32,5 +31,6 @@
   "theme.SearchPage.fetchingNewResults": "Új keresési eredmények betöltése...",
   "theme.SearchPage.inputLabel": "Keresés",
   "theme.SearchPage.inputPlaceholder": "Adja meg a keresendő kifejezést",
-  "theme.SearchPage.noResultsText": "Nincs találat a keresésre"
+  "theme.SearchPage.noResultsText": "Nincs találat a keresésre",
+  "theme.SearchPage.saveRecentSearchButtonTitle": "Mentse ezt a keresést"
 }
diff --git a/packages/docusaurus-theme-translations/locales/it/theme-common.json b/packages/docusaurus-theme-translations/locales/it/theme-common.json
index a889a9872cff..a8e22db33655 100644
--- a/packages/docusaurus-theme-translations/locales/it/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/it/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "informazioni",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "mancia",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archivio",
   "theme.blog.archive.title": "Archivio",
   "theme.blog.paginator.navAriaLabel": "Navigazione nella pagina dei post del blog ",
diff --git a/packages/docusaurus-theme-translations/locales/ja/theme-common.json b/packages/docusaurus-theme-translations/locales/ja/theme-common.json
index ac10dc533e1a..317c2ee3ee39 100644
--- a/packages/docusaurus-theme-translations/locales/ja/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/ja/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "備考",
   "theme.admonition.note": "注記",
   "theme.admonition.tip": "ヒント",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "アーカイブ",
   "theme.blog.archive.title": "アーカイブ",
   "theme.blog.paginator.navAriaLabel": "ブログ記事一覧のナビゲーション",
diff --git a/packages/docusaurus-theme-translations/locales/ko/theme-common.json b/packages/docusaurus-theme-translations/locales/ko/theme-common.json
index b5237e0abde2..ae6903ba1d6c 100644
--- a/packages/docusaurus-theme-translations/locales/ko/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/ko/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "정보",
   "theme.admonition.note": "노트",
   "theme.admonition.tip": "팁",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "게시물 목록",
   "theme.blog.archive.title": "게시물 목록",
   "theme.blog.paginator.navAriaLabel": "블로그 게시물 목록 탐색",
diff --git a/packages/docusaurus-theme-translations/locales/nb/theme-common.json b/packages/docusaurus-theme-translations/locales/nb/theme-common.json
index 62ab5577c3ee..57ea71ddca2b 100644
--- a/packages/docusaurus-theme-translations/locales/nb/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/nb/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "merknad",
   "theme.admonition.tip": "tips",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Arkiv",
   "theme.blog.archive.title": "Arkiv",
   "theme.blog.paginator.navAriaLabel": "Navigering av bloggliste",
diff --git a/packages/docusaurus-theme-translations/locales/nl/theme-common.json b/packages/docusaurus-theme-translations/locales/nl/theme-common.json
index 76aaed23f20a..36c75b00d32e 100644
--- a/packages/docusaurus-theme-translations/locales/nl/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/nl/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "notitie",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archief",
   "theme.blog.archive.title": "Archief",
   "theme.blog.paginator.navAriaLabel": "Paginanavigatie blog",
diff --git a/packages/docusaurus-theme-translations/locales/pl/theme-common.json b/packages/docusaurus-theme-translations/locales/pl/theme-common.json
index 48b1148d5824..12a5a8929fe9 100644
--- a/packages/docusaurus-theme-translations/locales/pl/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/pl/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "informacja",
   "theme.admonition.note": "notatka",
   "theme.admonition.tip": "wskazówka",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archiwum",
   "theme.blog.archive.title": "Archiwum",
   "theme.blog.paginator.navAriaLabel": "Nawigacja na stronie listy wpisów na blogu",
diff --git a/packages/docusaurus-theme-translations/locales/pt-BR/theme-common.json b/packages/docusaurus-theme-translations/locales/pt-BR/theme-common.json
index c2b00bd30b59..edf86395d97b 100644
--- a/packages/docusaurus-theme-translations/locales/pt-BR/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/pt-BR/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Arquivo",
   "theme.blog.archive.title": "Arquivo",
   "theme.blog.paginator.navAriaLabel": "Navegação da página de listagem do blog",
diff --git a/packages/docusaurus-theme-translations/locales/pt-PT/theme-common.json b/packages/docusaurus-theme-translations/locales/pt-PT/theme-common.json
index 65f2d5f89775..cea4db7fa3d1 100644
--- a/packages/docusaurus-theme-translations/locales/pt-PT/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/pt-PT/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Archive",
   "theme.blog.archive.title": "Archive",
   "theme.blog.paginator.navAriaLabel": "Navegação da página de listagem do blog",
diff --git a/packages/docusaurus-theme-translations/locales/ru/theme-common.json b/packages/docusaurus-theme-translations/locales/ru/theme-common.json
index 96aa3b98bbf7..cdf7d51b20b1 100644
--- a/packages/docusaurus-theme-translations/locales/ru/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/ru/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "к сведению",
   "theme.admonition.note": "примечание",
   "theme.admonition.tip": "подсказка",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Архив",
   "theme.blog.archive.title": "Архив",
   "theme.blog.paginator.navAriaLabel": "Навигация по странице списка блогов",
diff --git a/packages/docusaurus-theme-translations/locales/sl/theme-common.json b/packages/docusaurus-theme-translations/locales/sl/theme-common.json
index e2f50862463d..c072cde0edad 100644
--- a/packages/docusaurus-theme-translations/locales/sl/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/sl/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "informacija",
   "theme.admonition.note": "opomba",
   "theme.admonition.tip": "namig",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Arhiv",
   "theme.blog.archive.title": "Arhiv",
   "theme.blog.paginator.navAriaLabel": "Navigacija kazala po blogu",
diff --git a/packages/docusaurus-theme-translations/locales/sr/theme-common.json b/packages/docusaurus-theme-translations/locales/sr/theme-common.json
index 8cf01d94279c..0f600118cdb7 100644
--- a/packages/docusaurus-theme-translations/locales/sr/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/sr/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "note",
   "theme.admonition.tip": "tip",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Архива",
   "theme.blog.archive.title": "Архива",
   "theme.blog.paginator.navAriaLabel": "Навигација за странице блога",
diff --git a/packages/docusaurus-theme-translations/locales/sv/theme-common.json b/packages/docusaurus-theme-translations/locales/sv/theme-common.json
index 8a2fe4704420..37075adecd0b 100644
--- a/packages/docusaurus-theme-translations/locales/sv/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/sv/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "info",
   "theme.admonition.note": "anteckning",
   "theme.admonition.tip": "tips",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Arkiv",
   "theme.blog.archive.title": "Arkiv",
   "theme.blog.paginator.navAriaLabel": "Navigation av Blogglista",
diff --git a/packages/docusaurus-theme-translations/locales/tr/theme-common.json b/packages/docusaurus-theme-translations/locales/tr/theme-common.json
index 673869abee47..1106d6a3eaac 100644
--- a/packages/docusaurus-theme-translations/locales/tr/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/tr/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "bilgi",
   "theme.admonition.note": "not",
   "theme.admonition.tip": "ipucu",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Arşiv",
   "theme.blog.archive.title": "Arşiv",
   "theme.blog.paginator.navAriaLabel": "Blog gönderi sayfası navigasyonu",
diff --git a/packages/docusaurus-theme-translations/locales/uk/theme-common.json b/packages/docusaurus-theme-translations/locales/uk/theme-common.json
index f62e5f6a5d6c..56ae2980ecc8 100644
--- a/packages/docusaurus-theme-translations/locales/uk/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/uk/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "інформація",
   "theme.admonition.note": "примітка",
   "theme.admonition.tip": "порада",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Архів",
   "theme.blog.archive.title": "Архів",
   "theme.blog.paginator.navAriaLabel": "Навігація по сторінці списку блогів",
diff --git a/packages/docusaurus-theme-translations/locales/vi/theme-common.json b/packages/docusaurus-theme-translations/locales/vi/theme-common.json
index 01728da7ae3b..4ced54b82ef4 100644
--- a/packages/docusaurus-theme-translations/locales/vi/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/vi/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "thông tin",
   "theme.admonition.note": "ghi chú",
   "theme.admonition.tip": "mẹo",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "Lưu trữ",
   "theme.blog.archive.title": "Lưu trữ",
   "theme.blog.paginator.navAriaLabel": "Thanh điều hướng của trang danh sách bài viết",
diff --git a/packages/docusaurus-theme-translations/locales/zh-Hans/theme-common.json b/packages/docusaurus-theme-translations/locales/zh-Hans/theme-common.json
index 8faa0785e640..4a1a07f260ff 100644
--- a/packages/docusaurus-theme-translations/locales/zh-Hans/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/zh-Hans/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "信息",
   "theme.admonition.note": "备注",
   "theme.admonition.tip": "提示",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "历史博文",
   "theme.blog.archive.title": "历史博文",
   "theme.blog.paginator.navAriaLabel": "博文列表分页导航",
diff --git a/packages/docusaurus-theme-translations/locales/zh-Hant/theme-common.json b/packages/docusaurus-theme-translations/locales/zh-Hant/theme-common.json
index bf587d691e99..667566b1fc34 100644
--- a/packages/docusaurus-theme-translations/locales/zh-Hant/theme-common.json
+++ b/packages/docusaurus-theme-translations/locales/zh-Hant/theme-common.json
@@ -19,6 +19,7 @@
   "theme.admonition.info": "信息",
   "theme.admonition.note": "備註",
   "theme.admonition.tip": "提示",
+  "theme.admonition.warning": "warning",
   "theme.blog.archive.description": "歷史文章",
   "theme.blog.archive.title": "歷史文章",
   "theme.blog.paginator.navAriaLabel": "部落格文章列表分頁導覽",
diff --git a/website/_dogfooding/_docs tests/tests/admonitions.mdx b/website/_dogfooding/_docs tests/tests/admonitions.mdx
index 1ecbb3c9a29e..9c41cffec208 100644
--- a/website/_dogfooding/_docs tests/tests/admonitions.mdx	
+++ b/website/_dogfooding/_docs tests/tests/admonitions.mdx	
@@ -53,3 +53,63 @@ import InfoIcon from "@theme/Admonition/Icon/Info"
     content
 </Admonition>
 ```
+
+## Official admonitions
+
+Admonitions that are [officially documented](/docs/markdown-features/admonitions)
+
+:::note
+
+note
+
+:::
+
+:::info
+
+info
+
+:::
+
+:::tip
+
+tip
+
+:::
+
+:::warning
+
+warning
+
+:::
+
+:::danger
+
+danger
+
+:::
+
+## Legacy admonitions
+
+:::secondary
+
+secondary
+
+:::
+
+:::important
+
+important
+
+:::
+
+:::success
+
+success
+
+:::
+
+:::caution
+
+caution
+
+:::
diff --git a/website/_dogfooding/_pages tests/markdown-tests-mdx.mdx b/website/_dogfooding/_pages tests/markdown-tests-mdx.mdx
index 1b8a41ab51ea..037a1f9e6458 100644
--- a/website/_dogfooding/_pages tests/markdown-tests-mdx.mdx	
+++ b/website/_dogfooding/_pages tests/markdown-tests-mdx.mdx	
@@ -271,13 +271,13 @@ Emojis in this text will be replaced with [remark-emoji](https://www.npmjs.com/p
 
 ## Admonitions
 
-:::caution Interpolated `title` with a <button style={{color: "red"}} onClick={() => alert("it works")}>button</button> (old syntax)
+:::warning Interpolated `title` with a <button style={{color: "red"}} onClick={() => alert("it works")}>button</button> (old syntax)
 
 Admonition body
 
 :::
 
-:::caution[Interpolated `title` with a <button style={{color: "red"}} onClick={() => alert("it works")}>button</button> (directive label syntax)]
+:::warning[Interpolated `title` with a <button style={{color: "red"}} onClick={() => alert("it works")}>button</button> (directive label syntax)]
 
 Admonition body
 
diff --git a/website/blog/releases/2.3/index.mdx b/website/blog/releases/2.3/index.mdx
index a570d9cfe05d..2ce5005ae463 100644
--- a/website/blog/releases/2.3/index.mdx
+++ b/website/blog/releases/2.3/index.mdx
@@ -22,7 +22,7 @@ Google Tag Manager is a tag management system that allows great flexibility. It
 
 We now have a [`@docusaurus/plugin-google-tag-manager`](/docs/api/plugins/@docusaurus/plugin-google-tag-manager/) package that you can use alongside or as an alternative to the existing [gtag.js plugin](/docs/api/plugins/@docusaurus/plugin-google-gtag/) (refer to [this doc](https://support.google.com/tagmanager/answer/7582054) to understand when to use which solution).
 
-:::caution Google is sunsetting Universal Analytics
+:::warning Google is sunsetting Universal Analytics
 
 [Google will sunset its Universal Analytics](https://blog.google/products/marketingplatform/analytics/prepare-for-future-with-google-analytics-4/) on **July 1, 2023**, and ask users to migrate to **Google Analytics 4**.
 
diff --git a/website/blog/releases/2.4/index.mdx b/website/blog/releases/2.4/index.mdx
index d02dfd35448c..7eeea9aabbf8 100644
--- a/website/blog/releases/2.4/index.mdx
+++ b/website/blog/releases/2.4/index.mdx
@@ -104,7 +104,7 @@ module.exports = {
 };
 ```
 
-:::caution Google is sunsetting Universal Analytics
+:::warning Google is sunsetting Universal Analytics
 
 **[Google will sunset its Universal Analytics](https://blog.google/products/marketingplatform/analytics/prepare-for-future-with-google-analytics-4/)** on **July 1, 2023**.
 
diff --git a/website/community/4-canary.mdx b/website/community/4-canary.mdx
index a6f278899f10..698dd1f8acd7 100644
--- a/website/community/4-canary.mdx
+++ b/website/community/4-canary.mdx
@@ -32,7 +32,7 @@ A canary release passes all automated tests and is used in production by the Doc
 <InsertIfCanaryVersionUnknown>
 ```
 
-:::caution
+:::warning
 
 The canary version shown below **may not be up-to-date**. Please go to the [npm page](https://www.npmjs.com/package/@docusaurus/core?activeTab=versions) to find the actual version name.
 
@@ -97,7 +97,7 @@ You can also upgrade the `@docusaurus/*` packages with command line:
 npm install --save-exact @docusaurus/core@canary @docusaurus/preset-classic@canary
 ```
 
-:::caution
+:::warning
 
 Make sure to include all the `@docusaurus/*` packages.
 
diff --git a/website/community/5-release-process.mdx b/website/community/5-release-process.mdx
index a7d9d8c68bca..8185f7a4d320 100644
--- a/website/community/5-release-process.mdx
+++ b/website/community/5-release-process.mdx
@@ -121,7 +121,7 @@ The next version passes all our automated tests and is used by the Docusaurus si
 
 :::
 
-:::caution
+:::warning
 
 Breaking changes can happen on the next version: detailed upgrade instructions are available in the changelog and pull requests.
 
diff --git a/website/docs/advanced/client.mdx b/website/docs/advanced/client.mdx
index 88762bd36209..dd77268610f3 100644
--- a/website/docs/advanced/client.mdx
+++ b/website/docs/advanced/client.mdx
@@ -52,7 +52,7 @@ export default function CodeBlock(props) {
 
 Check the code of `@docusaurus/theme-live-codeblock` for details.
 
-:::caution
+:::warning
 
 Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`.
 
diff --git a/website/docs/advanced/ssg.mdx b/website/docs/advanced/ssg.mdx
index 7fd0724ece35..07931249bbc8 100644
--- a/website/docs/advanced/ssg.mdx
+++ b/website/docs/advanced/ssg.mdx
@@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow
 
 You may need to escape from SSR since static HTML can't display anything useful without knowing the client state.
 
-:::caution
+:::warning
 
 It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements.
 
diff --git a/website/docs/api/docusaurus.config.js.mdx b/website/docs/api/docusaurus.config.js.mdx
index d1ca832e639e..35ab29326a61 100644
--- a/website/docs/api/docusaurus.config.js.mdx
+++ b/website/docs/api/docusaurus.config.js.mdx
@@ -652,7 +652,7 @@ module.exports = {
 
 ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png)
 
-:::caution
+:::warning
 
 This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL.
 
diff --git a/website/docs/api/misc/create-docusaurus.mdx b/website/docs/api/misc/create-docusaurus.mdx
index 587fc51da928..c79540e5641f 100644
--- a/website/docs/api/misc/create-docusaurus.mdx
+++ b/website/docs/api/misc/create-docusaurus.mdx
@@ -24,7 +24,7 @@ The `template` argument can be one of the following:
 
 The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD.
 
-:::caution
+:::warning
 
 This command should be preferably used in an interactive shell so all features are available.
 
diff --git a/website/docs/api/misc/logger/logger.mdx b/website/docs/api/misc/logger/logger.mdx
index 8ce3f5ac2925..4c0b37371eea 100644
--- a/website/docs/api/misc/logger/logger.mdx
+++ b/website/docs/api/misc/logger/logger.mdx
@@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi
   - `success`: prints a success message.
 - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity.
 
-:::caution A word on the `error` formatter
+:::warning A word on the `error` formatter
 
 Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly.
 
diff --git a/website/docs/api/plugin-methods/README.mdx b/website/docs/api/plugin-methods/README.mdx
index 970af327d0df..77ce21e5f955 100644
--- a/website/docs/api/plugin-methods/README.mdx
+++ b/website/docs/api/plugin-methods/README.mdx
@@ -1,6 +1,6 @@
 # Plugin Method References
 
-:::caution
+:::warning
 
 This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable.
 
diff --git a/website/docs/api/plugin-methods/extend-infrastructure.mdx b/website/docs/api/plugin-methods/extend-infrastructure.mdx
index 1885129b7007..339490376945 100644
--- a/website/docs/api/plugin-methods/extend-infrastructure.mdx
+++ b/website/docs/api/plugin-methods/extend-infrastructure.mdx
@@ -33,7 +33,7 @@ module.exports = function (context, options) {
 
 Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object.
 
-:::caution
+:::warning
 
 The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs.
 
diff --git a/website/docs/api/plugin-methods/lifecycle-apis.mdx b/website/docs/api/plugin-methods/lifecycle-apis.mdx
index 07257073f163..130884c6d65f 100644
--- a/website/docs/api/plugin-methods/lifecycle-apis.mdx
+++ b/website/docs/api/plugin-methods/lifecycle-apis.mdx
@@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro
 
 This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks.
 
-:::caution
+:::warning
 
 Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible.
 
@@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) {
 
 Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument.
 
-:::caution
+:::warning
 
 The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`)
 
diff --git a/website/docs/api/plugins/plugin-client-redirects.mdx b/website/docs/api/plugins/plugin-client-redirects.mdx
index 8e6bd08173f2..2f5c29d7761f 100644
--- a/website/docs/api/plugins/plugin-client-redirects.mdx
+++ b/website/docs/api/plugins/plugin-client-redirects.mdx
@@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**.
 
 This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
 :::
 
-:::caution
+:::warning
 
 It is better to use server-side redirects whenever possible.
 
diff --git a/website/docs/api/plugins/plugin-content-blog.mdx b/website/docs/api/plugins/plugin-content-blog.mdx
index b640dcae105e..17fbe8c36e98 100644
--- a/website/docs/api/plugins/plugin-content-blog.mdx
+++ b/website/docs/api/plugins/plugin-content-blog.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.
 
-:::caution some features production only
+:::warning some features production only
 
 The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**.
 
diff --git a/website/docs/api/plugins/plugin-google-analytics.mdx b/website/docs/api/plugins/plugin-google-analytics.mdx
index 97b5cc0f3fd0..555e5bea7277 100644
--- a/website/docs/api/plugins/plugin-google-analytics.mdx
+++ b/website/docs/api/plugins/plugin-google-analytics.mdx
@@ -19,7 +19,7 @@ If you are still using this plugin with a `UA-*` tracking id, you should create
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/docs/api/plugins/plugin-google-gtag.mdx b/website/docs/api/plugins/plugin-google-gtag.mdx
index dc1eeaf7b6fc..501b6c2f42c8 100644
--- a/website/docs/api/plugins/plugin-google-gtag.mdx
+++ b/website/docs/api/plugins/plugin-google-gtag.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/docs/api/plugins/plugin-google-tag-manager.mdx b/website/docs/api/plugins/plugin-google-tag-manager.mdx
index 6e3830a46d78..43182aec075d 100644
--- a/website/docs/api/plugins/plugin-google-tag-manager.mdx
+++ b/website/docs/api/plugins/plugin-google-tag-manager.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/docs/api/plugins/plugin-ideal-image.mdx b/website/docs/api/plugins/plugin-ideal-image.mdx
index 53564895d882..5613f4b981a2 100644
--- a/website/docs/api/plugins/plugin-ideal-image.mdx
+++ b/website/docs/api/plugins/plugin-ideal-image.mdx
@@ -36,7 +36,7 @@ import thumbnail from './path/to/img.png';
 <Image img={require('./path/to/img.png')} />
 ```
 
-:::caution
+:::warning
 
 This plugin registers a [Webpack loader](https://webpack.js.org/loaders/) that changes the type of imported/require images:
 
diff --git a/website/docs/api/plugins/plugin-pwa.mdx b/website/docs/api/plugins/plugin-pwa.mdx
index 2f2c8351b874..6f12d9402213 100644
--- a/website/docs/api/plugins/plugin-pwa.mdx
+++ b/website/docs/api/plugins/plugin-pwa.mdx
@@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th
 
 After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content.
 
-:::caution
+:::warning
 
 Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites.
 
@@ -124,7 +124,7 @@ Strategies used to turn the offline mode on:
 - `saveData`: activates for users with `navigator.connection.saveData === true`
 - `always`: activates for all users
 
-:::caution
+:::warning
 
 Use this carefully: some users may not like to be forced to use the offline mode.
 
diff --git a/website/docs/api/plugins/plugin-sitemap.mdx b/website/docs/api/plugins/plugin-sitemap.mdx
index 8bf823bc429f..0d6b72763c03 100644
--- a/website/docs/api/plugins/plugin-sitemap.mdx
+++ b/website/docs/api/plugins/plugin-sitemap.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
diff --git a/website/docs/api/themes/overview.mdx b/website/docs/api/themes/overview.mdx
index 4bb78e7ff0b1..98084d7418cc 100644
--- a/website/docs/api/themes/overview.mdx
+++ b/website/docs/api/themes/overview.mdx
@@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co
 - [@docusaurus/theme-classic](./theme-classic.mdx)
 - 🚧 other themes are planned
 
-:::caution
+:::warning
 
 The goal is to have all themes share the exact same features, user-experience and configuration.
 
diff --git a/website/docs/api/themes/theme-configuration.mdx b/website/docs/api/themes/theme-configuration.mdx
index 8fb5fe4a447a..1ca38a6a3537 100644
--- a/website/docs/api/themes/theme-configuration.mdx
+++ b/website/docs/api/themes/theme-configuration.mdx
@@ -51,7 +51,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences.
 
diff --git a/website/docs/blog.mdx b/website/docs/blog.mdx
index 3bd2e65875bb..0e13e66f3f76 100644
--- a/website/docs/blog.mdx
+++ b/website/docs/blog.mdx
@@ -374,7 +374,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml
 
 An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect.
 
-:::caution Feed generation
+:::warning Feed generation
 
 [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed.
 
@@ -619,7 +619,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route!
 
diff --git a/website/docs/browser-support.mdx b/website/docs/browser-support.mdx
index 404601d8f45e..79c01861d705 100644
--- a/website/docs/browser-support.mdx
+++ b/website/docs/browser-support.mdx
@@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th
 
 The browser list by default is provided through the `package.json` file as a root `browserslist` field.
 
-:::caution
+:::warning
 
 On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS.
 
diff --git a/website/docs/cli.mdx b/website/docs/cli.mdx
index de6e4babb64a..0b38c01776f7 100644
--- a/website/docs/cli.mdx
+++ b/website/docs/cli.mdx
@@ -46,7 +46,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https
 | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). |
 | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
-:::important
+:::info
 
 Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production.
 
@@ -125,7 +125,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro
 | `--typescript` | Swizzle the TypeScript variant component |
 | `--config` | Path to docusaurus config file, default to `[siteDir]/docusaurus.config.js` |
 
-:::caution
+:::warning
 
 Unsafe components have a higher risk of breaking changes due to internal refactorings.
 
diff --git a/website/docs/deployment.mdx b/website/docs/deployment.mdx
index 4e1945895aef..18a7e71e9126 100644
--- a/website/docs/deployment.mdx
+++ b/website/docs/deployment.mdx
@@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings
 
 Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`.
 
-:::caution
+:::warning
 
 Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites):
 
@@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params:
 
 These fields also have their environment variable counterparts which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`.
 
-:::caution
+:::warning
 
 GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`).
 
@@ -336,7 +336,7 @@ cmd /C 'set "GIT_USER=<GITHUB_USERNAME>" && yarn deploy'
 </Tabs>
 ```
 
-:::caution
+:::warning
 
 Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information.
 
diff --git a/website/docs/docusaurus-core.mdx b/website/docs/docusaurus-core.mdx
index 7e6615d8841e..40fcb7cd9fba 100644
--- a/website/docs/docusaurus-core.mdx
+++ b/website/docs/docusaurus-core.mdx
@@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client-
 
 - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout.
 
-:::caution
+:::warning
 
 The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback.
 
@@ -411,7 +411,7 @@ The `siteConfig` object only contains **serializable values** (values that are p
 
 Returns `true` when the React app has successfully hydrated in the browser.
 
-:::caution
+:::warning
 
 Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic.
 
@@ -437,7 +437,7 @@ const MyComponent = () => {
 
 React hook to prepend your site `baseUrl` to a string.
 
-:::caution
+:::warning
 
 **Don't use it for regular links!**
 
@@ -697,7 +697,7 @@ export default function Home() {
 
 A module that exposes a few boolean variables to check the current rendering environment.
 
-:::caution
+:::warning
 
 For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [`<BrowserOnly>`](#browseronly) instead.
 
diff --git a/website/docs/guides/creating-pages.mdx b/website/docs/guides/creating-pages.mdx
index 30ffdb9faf68..ce32424a2544 100644
--- a/website/docs/guides/creating-pages.mdx
+++ b/website/docs/guides/creating-pages.mdx
@@ -129,7 +129,7 @@ my-website
 .
 ```
 
-:::caution
+:::warning
 
 All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages).
 
diff --git a/website/docs/guides/docs/docs-introduction.mdx b/website/docs/guides/docs/docs-introduction.mdx
index 42b756a9f09f..fc24f14c7e1b 100644
--- a/website/docs/guides/docs/docs-introduction.mdx
+++ b/website/docs/guides/docs/docs-introduction.mdx
@@ -99,7 +99,7 @@ slug: /
 This page will be the home page when users visit https://example.com/.
 ```
 
-:::caution
+:::warning
 
 If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route!
 
diff --git a/website/docs/guides/docs/docs-multi-instance.mdx b/website/docs/guides/docs/docs-multi-instance.mdx
index c1acd0195b68..d9934e3bcebd 100644
--- a/website/docs/guides/docs/docs-multi-instance.mdx
+++ b/website/docs/guides/docs/docs-multi-instance.mdx
@@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations:
 
 In this case, you can use a distinct docs plugin instance per mobile SDK documentation.
 
-:::caution
+:::warning
 
 If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites.
 
@@ -55,7 +55,7 @@ Suppose you have 2 documentations:
 
 In this case, you should use the same plugin twice in your site configuration.
 
-:::caution
+:::warning
 
 `@docusaurus/preset-classic` already includes a docs plugin instance for you!
 
diff --git a/website/docs/guides/docs/sidebar/autogenerated.mdx b/website/docs/guides/docs/sidebar/autogenerated.mdx
index edaa670c6d03..b812da5e33b3 100644
--- a/website/docs/guides/docs/sidebar/autogenerated.mdx
+++ b/website/docs/guides/docs/sidebar/autogenerated.mdx
@@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat
 
 By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths.
 
-:::caution
+:::warning
 
 **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**.
 
diff --git a/website/docs/guides/docs/sidebar/items.mdx b/website/docs/guides/docs/sidebar/items.mdx
index 1e358a12fee6..77789ebf474c 100644
--- a/website/docs/guides/docs/sidebar/items.mdx
+++ b/website/docs/guides/docs/sidebar/items.mdx
@@ -400,7 +400,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded.
 
diff --git a/website/docs/guides/docs/versioning.mdx b/website/docs/guides/docs/versioning.mdx
index df27a964f07f..2b5657f48d81 100644
--- a/website/docs/guides/docs/versioning.mdx
+++ b/website/docs/guides/docs/versioning.mdx
@@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ```
 
-:::caution
+:::warning
 
 Think about it before starting to version your documentation - it can become difficult for contributors to help improve it!
 
diff --git a/website/docs/guides/markdown-features/markdown-features-admonitions.mdx b/website/docs/guides/markdown-features/markdown-features-admonitions.mdx
index d1ae1593159f..dde6799aabd8 100644
--- a/website/docs/guides/markdown-features/markdown-features-admonitions.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-admonitions.mdx
@@ -34,7 +34,7 @@ Some **content** with _Markdown_ `syntax`. Check [this `api`](#).
 
 :::
 
-:::caution
+:::warning
 
 Some **content** with _Markdown_ `syntax`. Check [this `api`](#).
 
@@ -68,7 +68,7 @@ Some **content** with _Markdown_ `syntax`. Check [this `api`](#).
 
 :::
 
-:::caution
+:::warning
 
 Some **content** with _Markdown_ `syntax`. Check [this `api`](#).
 
@@ -231,7 +231,7 @@ export default function MyReactPage() {
 }
 ```
 
-The types that are accepted are the same as above: `note`, `tip`, `danger`, `info`, `caution`. Optionally, you can specify an icon by passing a JSX element or a string, or a title:
+The types that are accepted are the same as above: `note`, `tip`, `danger`, `info`, `warning`. Optionally, you can specify an icon by passing a JSX element or a string, or a title:
 
 ```jsx title="MyReactPage.jsx"
 <Admonition type="tip" icon="💡" title="Did you know...">
@@ -282,7 +282,7 @@ module.exports = {
       {
         docs: {
           admonitions: {
-            keywords: ['note', 'tip', 'info', 'caution', 'danger'],
+            keywords: ['note', 'tip', 'info', 'warning', 'danger'],
             extendDefaults: true,
           },
         },
diff --git a/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx b/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx
index 6f87578892e0..e2f1dab444d0 100644
--- a/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if
 
 By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23).
 
-:::caution
+:::warning
 
 Some popular languages like Java, C#, or PHP are not enabled by default.
 
@@ -512,7 +512,7 @@ function Clock(props) {
 
 ### Imports {#imports}
 
-:::caution react-live and imports
+:::warning react-live and imports
 
 It is not possible to import components directly from the react-live code editor, you have to define available imports upfront.
 
@@ -644,13 +644,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use
   </pre>
 </BrowserWindow>
 
-:::caution MDX is whitespace insensitive
+:::warning MDX is whitespace insensitive
 
 MDX is in line with JSX behavior: line break characters, even when inside `<pre>`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/docs/guides/markdown-features/markdown-features-math-equations.mdx b/website/docs/guides/markdown-features/markdown-features-math-equations.mdx
index 1b1a8ad38d7a..74aa4349e55f 100644
--- a/website/docs/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@5 rehype-katex@6
 ```
 
-:::caution
+:::warning
 
 Make sure to use `remark-math >= 5` and `rehype-katex >= 6` for Docusaurus v3 (using MDX v2).
 
diff --git a/website/docs/guides/markdown-features/markdown-features-plugins.mdx b/website/docs/guides/markdown-features/markdown-features-plugins.mdx
index 1db6a6a67ee5..00c45da6b162 100644
--- a/website/docs/guides/markdown-features/markdown-features-plugins.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-plugins.mdx
@@ -57,7 +57,7 @@ Next, the `rehype-katex` operates on the Hypertext AST where everything has been
 
 </details>
 
-:::caution
+:::warning
 
 Many official Remark/Rehype plugins are using ES Modules, a new JavaScript module system, which Docusaurus doesn't support yet. To work around this issue, we recommend to use dynamic `import()` inside an `async` config creation function.
 
diff --git a/website/docs/guides/markdown-features/markdown-features-react.mdx b/website/docs/guides/markdown-features/markdown-features-react.mdx
index a8ca44af65a8..7722a6e5c5e6 100644
--- a/website/docs/guides/markdown-features/markdown-features-react.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-react.mdx
@@ -72,7 +72,7 @@ I can write **Markdown** alongside my _JSX_!
 </BrowserWindow>
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -198,7 +198,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [an `MDXProvider`](https://mdxjs.com/docs/using-mdx/#mdx-provider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -319,7 +319,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/docs/guides/markdown-features/markdown-features-toc.mdx b/website/docs/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f2559..bfc161c542ee 100644
--- a/website/docs/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/docs/i18n/i18n-crowdin.mdx b/website/docs/i18n/i18n-crowdin.mdx
index b57dbb71e093..b10c9246d82c 100644
--- a/website/docs/i18n/i18n-crowdin.mdx
+++ b/website/docs/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -394,7 +394,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -443,7 +443,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/docs/i18n/i18n-tutorial.mdx b/website/docs/i18n/i18n-tutorial.mdx
index 7e9de4cbb799..45057041fc7e 100644
--- a/website/docs/i18n/i18n-tutorial.mdx
+++ b/website/docs/i18n/i18n-tutorial.mdx
@@ -96,7 +96,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -123,7 +123,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `<Translate>` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`<option>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)) would [coerce it to a string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString), which returns `"[object Object]"`. While we encourage you to use `<Translate>` as JSX children, only use the element form when it actually works.
 
@@ -232,7 +232,7 @@ Most documentation websites are generally **static** and don't need advanced i18
 
 The `docusaurus write-translations` command will statically analyze all React code files used in your site, extract calls to these APIs, and aggregate them in the `code.json` file. The translation files will be stored as maps from IDs to translation message objects (including the translated label and the description of the label). In your calls to the translation APIs (`<Translate>` or `translate()`), you need to specify either the default untranslated message or the ID, in order for Docusaurus to correctly correlate each translation entry to the API call.
 
-:::caution text labels must be static
+:::warning text labels must be static
 
 The `docusaurus write-translations` command only does **static analysis** of your code. It doesn't actually run your site. Therefore, dynamic messages can't be extracted, as the message is an _expression_, not a _string_:
 
@@ -428,7 +428,7 @@ cp -r src/pages/**.md i18n/fr/docusaurus-plugin-content-pages
 cp -r src/pages/**.mdx i18n/fr/docusaurus-plugin-content-pages
 ```
 
-:::caution
+:::warning
 
 We only copy `.md` and `.mdx` files, as React pages are translated through JSON translation files already.
 
@@ -503,7 +503,7 @@ On your [static hosting provider](../deployment.mdx):
 - configure the appropriate build command, using the `--locale` option
 - configure the (sub)domain of your choice for each deployment
 
-:::caution
+:::warning
 
 This strategy is **not possible** with GitHub Pages, as it is only possible to **have a single deployment**.
 
diff --git a/website/docs/migration/migration-manual.mdx b/website/docs/migration/migration-manual.mdx
index a44c4ac8ca17..7f8984eab358 100644
--- a/website/docs/migration/migration-manual.mdx
+++ b/website/docs/migration/migration-manual.mdx
@@ -293,7 +293,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Your Algolia DocSearch v1 config (found [here](https://github.com/algolia/docsearch-configs/blob/master/configs)) should be updated for Docusaurus v2 ([example](https://github.com/algolia/docsearch-configs/tree/master/configs/docusaurus-2.json)).
 
diff --git a/website/docs/migration/migration-translated-sites.mdx b/website/docs/migration/migration-translated-sites.mdx
index 57aa277974c2..ddc48fd3b820 100644
--- a/website/docs/migration/migration-translated-sites.mdx
+++ b/website/docs/migration/migration-translated-sites.mdx
@@ -70,7 +70,7 @@ This section will help you figure out how to **keep your existing v1 translation
 
 There are **multiple possible strategies** to migrate a Docusaurus v1 site using Crowdin, with different tradeoffs.
 
-:::caution
+:::warning
 
 This documentation is a best-effort to help you migrate, please help us improve it if you find a better way!
 
@@ -150,7 +150,7 @@ Crowdin has an "upload translations" feature, but in our experience it does not
 
 If you don't mind modifying your existing Crowdin project and risking to mess things up, it may be possible to use the Crowdin branch system.
 
-:::caution
+:::warning
 
 This workflow has not been tested in practice, please report us how good it is.
 
diff --git a/website/docs/search.mdx b/website/docs/search.mdx
index 78f785bca0cb..3b260fcd7fe5 100644
--- a/website/docs/search.mdx
+++ b/website/docs/search.mdx
@@ -131,7 +131,7 @@ Refer to its [official DocSearch documentation](https://docsearch.algolia.com/do
 
 :::
 
-:::caution
+:::warning
 
 The search feature will not work reliably until Algolia crawls your site.
 
diff --git a/website/docs/seo.mdx b/website/docs/seo.mdx
index 048a23a66808..b411de7ea560 100644
--- a/website/docs/seo.mdx
+++ b/website/docs/seo.mdx
@@ -181,7 +181,7 @@ Disallow:
 
 Read more about the robots file in [the Google documentation](https://developers.google.com/search/docs/advanced/robots/intro).
 
-:::caution
+:::warning
 
 **Important**: the `robots.txt` file does **not** prevent HTML pages from being indexed.
 
diff --git a/website/docs/static-assets.mdx b/website/docs/static-assets.mdx
index eb9d319b3c87..29efce9e6cd3 100644
--- a/website/docs/static-assets.mdx
+++ b/website/docs/static-assets.mdx
@@ -69,7 +69,7 @@ You write a link like this: [Download this document](/files/note.docx)
 Docusaurus changes that to: <a href={require('static/files/note.docx')}>Download this document</a>
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `<a>` / `<img>`, nothing will be done.
 
diff --git a/website/docs/styling-layout.mdx b/website/docs/styling-layout.mdx
index af653e814174..68e872ff6cfb 100644
--- a/website/docs/styling-layout.mdx
+++ b/website/docs/styling-layout.mdx
@@ -215,7 +215,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/docs/swizzling.mdx b/website/docs/swizzling.mdx
index 8a0ba2976237..02f4d9a4386c 100644
--- a/website/docs/swizzling.mdx
+++ b/website/docs/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.
 
diff --git a/website/versioned_docs/version-2.0.1/advanced/client.mdx b/website/versioned_docs/version-2.0.1/advanced/client.mdx
index 189faab8ba56..6a01e76346da 100644
--- a/website/versioned_docs/version-2.0.1/advanced/client.mdx
+++ b/website/versioned_docs/version-2.0.1/advanced/client.mdx
@@ -52,7 +52,7 @@ export default function CodeBlock(props) {
 
 Check the code of `@docusaurus/theme-live-codeblock` for details.
 
-:::caution
+:::warning
 
 Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`.
 
diff --git a/website/versioned_docs/version-2.0.1/advanced/ssg.mdx b/website/versioned_docs/version-2.0.1/advanced/ssg.mdx
index 7fd0724ece35..07931249bbc8 100644
--- a/website/versioned_docs/version-2.0.1/advanced/ssg.mdx
+++ b/website/versioned_docs/version-2.0.1/advanced/ssg.mdx
@@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow
 
 You may need to escape from SSR since static HTML can't display anything useful without knowing the client state.
 
-:::caution
+:::warning
 
 It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements.
 
diff --git a/website/versioned_docs/version-2.0.1/api/docusaurus.config.js.mdx b/website/versioned_docs/version-2.0.1/api/docusaurus.config.js.mdx
index ae1803e5121f..b07293700c1a 100644
--- a/website/versioned_docs/version-2.0.1/api/docusaurus.config.js.mdx
+++ b/website/versioned_docs/version-2.0.1/api/docusaurus.config.js.mdx
@@ -569,7 +569,7 @@ module.exports = {
 
 ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png)
 
-:::caution
+:::warning
 
 This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL.
 
diff --git a/website/versioned_docs/version-2.0.1/api/misc/create-docusaurus.mdx b/website/versioned_docs/version-2.0.1/api/misc/create-docusaurus.mdx
index b4dc0491e4a8..039145e1dfc5 100644
--- a/website/versioned_docs/version-2.0.1/api/misc/create-docusaurus.mdx
+++ b/website/versioned_docs/version-2.0.1/api/misc/create-docusaurus.mdx
@@ -24,7 +24,7 @@ The `template` argument can be one of the following:
 
 The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD.
 
-:::caution
+:::warning
 
 This command should be preferably used in an interactive shell so all features are available.
 
diff --git a/website/versioned_docs/version-2.0.1/api/misc/logger/logger.mdx b/website/versioned_docs/version-2.0.1/api/misc/logger/logger.mdx
index 04800ed25b78..18ecf3ef07b1 100644
--- a/website/versioned_docs/version-2.0.1/api/misc/logger/logger.mdx
+++ b/website/versioned_docs/version-2.0.1/api/misc/logger/logger.mdx
@@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi
   - `success`: prints a success message.
 - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity.
 
-:::caution A word on the `error` formatter
+:::warning A word on the `error` formatter
 
 Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly.
 
diff --git a/website/versioned_docs/version-2.0.1/api/plugin-methods/README.mdx b/website/versioned_docs/version-2.0.1/api/plugin-methods/README.mdx
index 970af327d0df..77ce21e5f955 100644
--- a/website/versioned_docs/version-2.0.1/api/plugin-methods/README.mdx
+++ b/website/versioned_docs/version-2.0.1/api/plugin-methods/README.mdx
@@ -1,6 +1,6 @@
 # Plugin Method References
 
-:::caution
+:::warning
 
 This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable.
 
diff --git a/website/versioned_docs/version-2.0.1/api/plugin-methods/extend-infrastructure.mdx b/website/versioned_docs/version-2.0.1/api/plugin-methods/extend-infrastructure.mdx
index 1885129b7007..339490376945 100644
--- a/website/versioned_docs/version-2.0.1/api/plugin-methods/extend-infrastructure.mdx
+++ b/website/versioned_docs/version-2.0.1/api/plugin-methods/extend-infrastructure.mdx
@@ -33,7 +33,7 @@ module.exports = function (context, options) {
 
 Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object.
 
-:::caution
+:::warning
 
 The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs.
 
diff --git a/website/versioned_docs/version-2.0.1/api/plugin-methods/lifecycle-apis.mdx b/website/versioned_docs/version-2.0.1/api/plugin-methods/lifecycle-apis.mdx
index 050bd5870b13..4d0dad6521e2 100644
--- a/website/versioned_docs/version-2.0.1/api/plugin-methods/lifecycle-apis.mdx
+++ b/website/versioned_docs/version-2.0.1/api/plugin-methods/lifecycle-apis.mdx
@@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro
 
 This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks.
 
-:::caution
+:::warning
 
 Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible.
 
@@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) {
 
 Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument.
 
-:::caution
+:::warning
 
 The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`)
 
diff --git a/website/versioned_docs/version-2.0.1/api/plugins/plugin-client-redirects.mdx b/website/versioned_docs/version-2.0.1/api/plugins/plugin-client-redirects.mdx
index 8e6bd08173f2..2f5c29d7761f 100644
--- a/website/versioned_docs/version-2.0.1/api/plugins/plugin-client-redirects.mdx
+++ b/website/versioned_docs/version-2.0.1/api/plugins/plugin-client-redirects.mdx
@@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**.
 
 This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
 :::
 
-:::caution
+:::warning
 
 It is better to use server-side redirects whenever possible.
 
diff --git a/website/versioned_docs/version-2.0.1/api/plugins/plugin-content-blog.mdx b/website/versioned_docs/version-2.0.1/api/plugins/plugin-content-blog.mdx
index b20a58284bc5..72179a2c00bb 100644
--- a/website/versioned_docs/version-2.0.1/api/plugins/plugin-content-blog.mdx
+++ b/website/versioned_docs/version-2.0.1/api/plugins/plugin-content-blog.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.
 
-:::caution some features production only
+:::warning some features production only
 
 The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**.
 
diff --git a/website/versioned_docs/version-2.0.1/api/plugins/plugin-google-analytics.mdx b/website/versioned_docs/version-2.0.1/api/plugins/plugin-google-analytics.mdx
index b3b77732b442..33a5d2bf79bd 100644
--- a/website/versioned_docs/version-2.0.1/api/plugins/plugin-google-analytics.mdx
+++ b/website/versioned_docs/version-2.0.1/api/plugins/plugin-google-analytics.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 The default [Google Analytics](https://developers.google.com/analytics/devguides/collection/analyticsjs/) plugin. It is a JavaScript library for measuring how users interact with your website **in the production build**. If you are using Google Analytics 4 you might need to consider using [plugin-google-gtag](./plugin-google-gtag.mdx) instead.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.0.1/api/plugins/plugin-google-gtag.mdx b/website/versioned_docs/version-2.0.1/api/plugins/plugin-google-gtag.mdx
index fca251edd3bb..7eb16e0dd11d 100644
--- a/website/versioned_docs/version-2.0.1/api/plugins/plugin-google-gtag.mdx
+++ b/website/versioned_docs/version-2.0.1/api/plugins/plugin-google-gtag.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.0.1/api/plugins/plugin-pwa.mdx b/website/versioned_docs/version-2.0.1/api/plugins/plugin-pwa.mdx
index b6c2b287e186..2f96eddffa71 100644
--- a/website/versioned_docs/version-2.0.1/api/plugins/plugin-pwa.mdx
+++ b/website/versioned_docs/version-2.0.1/api/plugins/plugin-pwa.mdx
@@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th
 
 After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content.
 
-:::caution
+:::warning
 
 Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites.
 
@@ -124,7 +124,7 @@ Strategies used to turn the offline mode on:
 - `saveData`: activates for users with `navigator.connection.saveData === true`
 - `always`: activates for all users
 
-:::caution
+:::warning
 
 Use this carefully: some users may not like to be forced to use the offline mode.
 
diff --git a/website/versioned_docs/version-2.0.1/api/plugins/plugin-sitemap.mdx b/website/versioned_docs/version-2.0.1/api/plugins/plugin-sitemap.mdx
index 8bf823bc429f..0d6b72763c03 100644
--- a/website/versioned_docs/version-2.0.1/api/plugins/plugin-sitemap.mdx
+++ b/website/versioned_docs/version-2.0.1/api/plugins/plugin-sitemap.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
diff --git a/website/versioned_docs/version-2.0.1/api/themes/overview.mdx b/website/versioned_docs/version-2.0.1/api/themes/overview.mdx
index 4bb78e7ff0b1..98084d7418cc 100644
--- a/website/versioned_docs/version-2.0.1/api/themes/overview.mdx
+++ b/website/versioned_docs/version-2.0.1/api/themes/overview.mdx
@@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co
 - [@docusaurus/theme-classic](./theme-classic.mdx)
 - 🚧 other themes are planned
 
-:::caution
+:::warning
 
 The goal is to have all themes share the exact same features, user-experience and configuration.
 
diff --git a/website/versioned_docs/version-2.0.1/api/themes/theme-configuration.mdx b/website/versioned_docs/version-2.0.1/api/themes/theme-configuration.mdx
index 90259d778137..2247d5417297 100644
--- a/website/versioned_docs/version-2.0.1/api/themes/theme-configuration.mdx
+++ b/website/versioned_docs/version-2.0.1/api/themes/theme-configuration.mdx
@@ -51,7 +51,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences.
 
diff --git a/website/versioned_docs/version-2.0.1/blog.mdx b/website/versioned_docs/version-2.0.1/blog.mdx
index 66d728ddf91a..ace263ad736e 100644
--- a/website/versioned_docs/version-2.0.1/blog.mdx
+++ b/website/versioned_docs/version-2.0.1/blog.mdx
@@ -365,7 +365,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml
 
 An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect.
 
-:::caution Feed generation
+:::warning Feed generation
 
 [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed.
 
@@ -590,7 +590,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.0.1/browser-support.mdx b/website/versioned_docs/version-2.0.1/browser-support.mdx
index 404601d8f45e..79c01861d705 100644
--- a/website/versioned_docs/version-2.0.1/browser-support.mdx
+++ b/website/versioned_docs/version-2.0.1/browser-support.mdx
@@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th
 
 The browser list by default is provided through the `package.json` file as a root `browserslist` field.
 
-:::caution
+:::warning
 
 On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS.
 
diff --git a/website/versioned_docs/version-2.0.1/cli.mdx b/website/versioned_docs/version-2.0.1/cli.mdx
index 2f57a03ba0d8..1923f1cc97ac 100644
--- a/website/versioned_docs/version-2.0.1/cli.mdx
+++ b/website/versioned_docs/version-2.0.1/cli.mdx
@@ -45,7 +45,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https
 | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). |
 | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
-:::important
+:::info
 
 Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production.
 
@@ -123,7 +123,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro
 | `--danger`      | Allow immediate swizzling of unsafe components        |
 | `--typescript`  | Swizzle the TypeScript variant component              |
 
-:::caution
+:::warning
 
 Unsafe components have a higher risk of breaking changes due to internal refactorings.
 
diff --git a/website/versioned_docs/version-2.0.1/deployment.mdx b/website/versioned_docs/version-2.0.1/deployment.mdx
index 3a20f0b64b1b..f1007b91e753 100644
--- a/website/versioned_docs/version-2.0.1/deployment.mdx
+++ b/website/versioned_docs/version-2.0.1/deployment.mdx
@@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings
 
 Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`.
 
-:::caution
+:::warning
 
 Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites):
 
@@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params:
 
 These fields also have their environment variable counterparts, which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`.
 
-:::caution
+:::warning
 
 GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`).
 
@@ -334,7 +334,7 @@ cmd /C 'set "GIT_USER=<GITHUB_USERNAME>" && yarn deploy'
 </Tabs>
 ```
 
-:::caution
+:::warning
 
 Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information.
 
diff --git a/website/versioned_docs/version-2.0.1/docusaurus-core.mdx b/website/versioned_docs/version-2.0.1/docusaurus-core.mdx
index 409a6082c9d7..12ba618d86c0 100644
--- a/website/versioned_docs/version-2.0.1/docusaurus-core.mdx
+++ b/website/versioned_docs/version-2.0.1/docusaurus-core.mdx
@@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client-
 
 - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout.
 
-:::caution
+:::warning
 
 The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback.
 
@@ -405,7 +405,7 @@ The `siteConfig` object only contains **serializable values** (values that are p
 
 Returns `true` when the React app has successfully hydrated in the browser.
 
-:::caution
+:::warning
 
 Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic.
 
@@ -431,7 +431,7 @@ const MyComponent = () => {
 
 React hook to prepend your site `baseUrl` to a string.
 
-:::caution
+:::warning
 
 **Don't use it for regular links!**
 
@@ -691,7 +691,7 @@ export default function Home() {
 
 A module that exposes a few boolean variables to check the current rendering environment.
 
-:::caution
+:::warning
 
 For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [`<BrowserOnly>`](#browseronly) instead.
 
diff --git a/website/versioned_docs/version-2.0.1/guides/creating-pages.mdx b/website/versioned_docs/version-2.0.1/guides/creating-pages.mdx
index 30ffdb9faf68..ce32424a2544 100644
--- a/website/versioned_docs/version-2.0.1/guides/creating-pages.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/creating-pages.mdx
@@ -129,7 +129,7 @@ my-website
 .
 ```
 
-:::caution
+:::warning
 
 All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages).
 
diff --git a/website/versioned_docs/version-2.0.1/guides/docs/docs-introduction.mdx b/website/versioned_docs/version-2.0.1/guides/docs/docs-introduction.mdx
index 250342e26b80..6e27e6be7705 100644
--- a/website/versioned_docs/version-2.0.1/guides/docs/docs-introduction.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/docs/docs-introduction.mdx
@@ -95,7 +95,7 @@ slug: /
 This page will be the home page when users visit https://example.com/.
 ```
 
-:::caution
+:::warning
 
 If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.0.1/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-2.0.1/guides/docs/docs-multi-instance.mdx
index c1acd0195b68..d9934e3bcebd 100644
--- a/website/versioned_docs/version-2.0.1/guides/docs/docs-multi-instance.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/docs/docs-multi-instance.mdx
@@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations:
 
 In this case, you can use a distinct docs plugin instance per mobile SDK documentation.
 
-:::caution
+:::warning
 
 If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites.
 
@@ -55,7 +55,7 @@ Suppose you have 2 documentations:
 
 In this case, you should use the same plugin twice in your site configuration.
 
-:::caution
+:::warning
 
 `@docusaurus/preset-classic` already includes a docs plugin instance for you!
 
diff --git a/website/versioned_docs/version-2.0.1/guides/docs/sidebar/autogenerated.mdx b/website/versioned_docs/version-2.0.1/guides/docs/sidebar/autogenerated.mdx
index c489689dc6ec..4ac6fa6e620f 100644
--- a/website/versioned_docs/version-2.0.1/guides/docs/sidebar/autogenerated.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/docs/sidebar/autogenerated.mdx
@@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat
 
 By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths.
 
-:::caution
+:::warning
 
 **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**.
 
diff --git a/website/versioned_docs/version-2.0.1/guides/docs/sidebar/items.mdx b/website/versioned_docs/version-2.0.1/guides/docs/sidebar/items.mdx
index 7cb6c6916a6a..2f1832a6e5cc 100644
--- a/website/versioned_docs/version-2.0.1/guides/docs/sidebar/items.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/docs/sidebar/items.mdx
@@ -392,7 +392,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded.
 
diff --git a/website/versioned_docs/version-2.0.1/guides/docs/versioning.mdx b/website/versioned_docs/version-2.0.1/guides/docs/versioning.mdx
index df27a964f07f..2b5657f48d81 100644
--- a/website/versioned_docs/version-2.0.1/guides/docs/versioning.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/docs/versioning.mdx
@@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ```
 
-:::caution
+:::warning
 
 Think about it before starting to version your documentation - it can become difficult for contributors to help improve it!
 
diff --git a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-code-blocks.mdx
index 1871536619bd..cccf4f45e3f8 100644
--- a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if
 
 By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23).
 
-:::caution
+:::warning
 
 Some popular languages like Java, C#, or PHP are not enabled by default.
 
@@ -510,7 +510,7 @@ function Clock(props) {
 
 ### Imports {#imports}
 
-:::caution react-live and imports
+:::warning react-live and imports
 
 It is not possible to import components directly from the react-live code editor, you have to define available imports upfront.
 
@@ -642,13 +642,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use
   </pre>
 </BrowserWindow>
 
-:::caution MDX is whitespace insensitive
+:::warning MDX is whitespace insensitive
 
 MDX is in line with JSX behavior: line break characters, even when inside `<pre>`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-intro.mdx
index 30212e50042f..643f621c5b76 100644
--- a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-intro.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-intro.mdx
@@ -12,7 +12,7 @@ Documentation is one of your product's interfaces with your users. A well-writte
 
 Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users.
 
-:::important
+:::info
 
 This section assumes you are using the official Docusaurus content plugins.
 
diff --git a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-math-equations.mdx
index 631a9dbaa5d3..cb218c280cc4 100644
--- a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@3 rehype-katex@5 hast-util-is-element@1.1.0
 ```
 
-:::caution
+:::warning
 
 Use the exact same versions. The latest versions are incompatible with Docusaurus 2.
 
diff --git a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-react.mdx
index da8e9fd86be0..ba8b213e386f 100644
--- a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-react.mdx
@@ -72,7 +72,7 @@ I can write **Markdown** alongside my _JSX_!
 </BrowserWindow>
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -202,7 +202,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [a wrapper provider](https://mdx-git-renovate-babel-monorepo-mdx.vercel.app/advanced/components#mdxprovider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -525,7 +525,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f2559..bfc161c542ee 100644
--- a/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/versioned_docs/version-2.0.1/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/versioned_docs/version-2.0.1/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.0.1/i18n/i18n-crowdin.mdx
index bd0306091f62..011b332d4ab6 100644
--- a/website/versioned_docs/version-2.0.1/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-2.0.1/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -393,7 +393,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -442,7 +442,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/versioned_docs/version-2.0.1/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-2.0.1/i18n/i18n-tutorial.mdx
index 1cdd4e6e4bc0..de7c22845af1 100644
--- a/website/versioned_docs/version-2.0.1/i18n/i18n-tutorial.mdx
+++ b/website/versioned_docs/version-2.0.1/i18n/i18n-tutorial.mdx
@@ -88,7 +88,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -115,7 +115,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `<Translate>` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`<option>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)) would [coerce it to a string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString), which returns `"[object Object]"`. While we encourage you to use `<Translate>` as JSX children, only use the element form when it actually works.
 
@@ -224,7 +224,7 @@ Most documentation websites are generally **static** and don't need advanced i18
 
 The `docusaurus write-translations` command will statically analyze all React code files used in your site, extract calls to these APIs, and aggregate them in the `code.json` file. The translation files will be stored as maps from IDs to translation message objects (including the translated label and the description of the label). In your calls to the translation APIs (`<Translate>` or `translate()`), you need to specify either the default untranslated message or the ID, in order for Docusaurus to correctly correlate each translation entry to the API call.
 
-:::caution text labels must be static
+:::warning text labels must be static
 
 The `docusaurus write-translations` command only does **static analysis** of your code. It doesn't actually run your site. Therefore, dynamic messages can't be extracted, as the message is an _expression_, not a _string_:
 
@@ -420,7 +420,7 @@ cp -r src/pages/**.md i18n/fr/docusaurus-plugin-content-pages
 cp -r src/pages/**.mdx i18n/fr/docusaurus-plugin-content-pages
 ```
 
-:::caution
+:::warning
 
 We only copy `.md` and `.mdx` files, as React pages are translated through JSON translation files already.
 
@@ -495,7 +495,7 @@ On your [static hosting provider](../deployment.mdx):
 - configure the appropriate build command, using the `--locale` option
 - configure the (sub)domain of your choice for each deployment
 
-:::caution
+:::warning
 
 This strategy is **not possible** with GitHub Pages, as it is only possible to **have a single deployment**.
 
diff --git a/website/versioned_docs/version-2.0.1/migration/migration-manual.mdx b/website/versioned_docs/version-2.0.1/migration/migration-manual.mdx
index 517d158f199e..64eed5c20e7e 100644
--- a/website/versioned_docs/version-2.0.1/migration/migration-manual.mdx
+++ b/website/versioned_docs/version-2.0.1/migration/migration-manual.mdx
@@ -293,7 +293,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Your Algolia DocSearch v1 config (found [here](https://github.com/algolia/docsearch-configs/blob/master/configs)) should be updated for Docusaurus v2 ([example](https://github.com/algolia/docsearch-configs/tree/master/configs/docusaurus-2.json)).
 
diff --git a/website/versioned_docs/version-2.0.1/migration/migration-translated-sites.mdx b/website/versioned_docs/version-2.0.1/migration/migration-translated-sites.mdx
index 57aa277974c2..ddc48fd3b820 100644
--- a/website/versioned_docs/version-2.0.1/migration/migration-translated-sites.mdx
+++ b/website/versioned_docs/version-2.0.1/migration/migration-translated-sites.mdx
@@ -70,7 +70,7 @@ This section will help you figure out how to **keep your existing v1 translation
 
 There are **multiple possible strategies** to migrate a Docusaurus v1 site using Crowdin, with different tradeoffs.
 
-:::caution
+:::warning
 
 This documentation is a best-effort to help you migrate, please help us improve it if you find a better way!
 
@@ -150,7 +150,7 @@ Crowdin has an "upload translations" feature, but in our experience it does not
 
 If you don't mind modifying your existing Crowdin project and risking to mess things up, it may be possible to use the Crowdin branch system.
 
-:::caution
+:::warning
 
 This workflow has not been tested in practice, please report us how good it is.
 
diff --git a/website/versioned_docs/version-2.0.1/search.mdx b/website/versioned_docs/version-2.0.1/search.mdx
index c1dad98ff9a8..bc08bb664224 100644
--- a/website/versioned_docs/version-2.0.1/search.mdx
+++ b/website/versioned_docs/version-2.0.1/search.mdx
@@ -125,7 +125,7 @@ Refer to its [official DocSearch documentation](https://docsearch.algolia.com/do
 
 :::
 
-:::caution
+:::warning
 
 The search feature will not work reliably until Algolia crawls your site.
 
diff --git a/website/versioned_docs/version-2.0.1/seo.mdx b/website/versioned_docs/version-2.0.1/seo.mdx
index e18b33335201..1a967a252420 100644
--- a/website/versioned_docs/version-2.0.1/seo.mdx
+++ b/website/versioned_docs/version-2.0.1/seo.mdx
@@ -122,7 +122,7 @@ Disallow:
 
 Read more about the robots file in [the Google documentation](https://developers.google.com/search/docs/advanced/robots/intro).
 
-:::caution
+:::warning
 
 **Important**: the `robots.txt` file does **not** prevent HTML pages from being indexed. Use `<meta name="robots" content="noindex">` as [page metadata](#single-page-metadata) to prevent it from appearing in search results entirely.
 
diff --git a/website/versioned_docs/version-2.0.1/static-assets.mdx b/website/versioned_docs/version-2.0.1/static-assets.mdx
index eb9d319b3c87..29efce9e6cd3 100644
--- a/website/versioned_docs/version-2.0.1/static-assets.mdx
+++ b/website/versioned_docs/version-2.0.1/static-assets.mdx
@@ -69,7 +69,7 @@ You write a link like this: [Download this document](/files/note.docx)
 Docusaurus changes that to: <a href={require('static/files/note.docx')}>Download this document</a>
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `<a>` / `<img>`, nothing will be done.
 
diff --git a/website/versioned_docs/version-2.0.1/styling-layout.mdx b/website/versioned_docs/version-2.0.1/styling-layout.mdx
index d11c8ab07498..289aafa20575 100644
--- a/website/versioned_docs/version-2.0.1/styling-layout.mdx
+++ b/website/versioned_docs/version-2.0.1/styling-layout.mdx
@@ -178,7 +178,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/versioned_docs/version-2.0.1/swizzling.mdx b/website/versioned_docs/version-2.0.1/swizzling.mdx
index dcddfbe07864..21ef6eb1d0d5 100644
--- a/website/versioned_docs/version-2.0.1/swizzling.mdx
+++ b/website/versioned_docs/version-2.0.1/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.
 
diff --git a/website/versioned_docs/version-2.1.0/advanced/client.mdx b/website/versioned_docs/version-2.1.0/advanced/client.mdx
index 189faab8ba56..6a01e76346da 100644
--- a/website/versioned_docs/version-2.1.0/advanced/client.mdx
+++ b/website/versioned_docs/version-2.1.0/advanced/client.mdx
@@ -52,7 +52,7 @@ export default function CodeBlock(props) {
 
 Check the code of `@docusaurus/theme-live-codeblock` for details.
 
-:::caution
+:::warning
 
 Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`.
 
diff --git a/website/versioned_docs/version-2.1.0/advanced/ssg.mdx b/website/versioned_docs/version-2.1.0/advanced/ssg.mdx
index 7fd0724ece35..07931249bbc8 100644
--- a/website/versioned_docs/version-2.1.0/advanced/ssg.mdx
+++ b/website/versioned_docs/version-2.1.0/advanced/ssg.mdx
@@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow
 
 You may need to escape from SSR since static HTML can't display anything useful without knowing the client state.
 
-:::caution
+:::warning
 
 It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements.
 
diff --git a/website/versioned_docs/version-2.1.0/api/docusaurus.config.js.mdx b/website/versioned_docs/version-2.1.0/api/docusaurus.config.js.mdx
index a6c5215fc274..7b8c86edc71e 100644
--- a/website/versioned_docs/version-2.1.0/api/docusaurus.config.js.mdx
+++ b/website/versioned_docs/version-2.1.0/api/docusaurus.config.js.mdx
@@ -565,7 +565,7 @@ module.exports = {
 
 ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png)
 
-:::caution
+:::warning
 
 This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL.
 
diff --git a/website/versioned_docs/version-2.1.0/api/misc/create-docusaurus.mdx b/website/versioned_docs/version-2.1.0/api/misc/create-docusaurus.mdx
index b4dc0491e4a8..039145e1dfc5 100644
--- a/website/versioned_docs/version-2.1.0/api/misc/create-docusaurus.mdx
+++ b/website/versioned_docs/version-2.1.0/api/misc/create-docusaurus.mdx
@@ -24,7 +24,7 @@ The `template` argument can be one of the following:
 
 The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD.
 
-:::caution
+:::warning
 
 This command should be preferably used in an interactive shell so all features are available.
 
diff --git a/website/versioned_docs/version-2.1.0/api/misc/logger/logger.mdx b/website/versioned_docs/version-2.1.0/api/misc/logger/logger.mdx
index 04800ed25b78..18ecf3ef07b1 100644
--- a/website/versioned_docs/version-2.1.0/api/misc/logger/logger.mdx
+++ b/website/versioned_docs/version-2.1.0/api/misc/logger/logger.mdx
@@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi
   - `success`: prints a success message.
 - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity.
 
-:::caution A word on the `error` formatter
+:::warning A word on the `error` formatter
 
 Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugin-methods/README.mdx b/website/versioned_docs/version-2.1.0/api/plugin-methods/README.mdx
index 970af327d0df..77ce21e5f955 100644
--- a/website/versioned_docs/version-2.1.0/api/plugin-methods/README.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugin-methods/README.mdx
@@ -1,6 +1,6 @@
 # Plugin Method References
 
-:::caution
+:::warning
 
 This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugin-methods/extend-infrastructure.mdx b/website/versioned_docs/version-2.1.0/api/plugin-methods/extend-infrastructure.mdx
index 1885129b7007..339490376945 100644
--- a/website/versioned_docs/version-2.1.0/api/plugin-methods/extend-infrastructure.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugin-methods/extend-infrastructure.mdx
@@ -33,7 +33,7 @@ module.exports = function (context, options) {
 
 Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object.
 
-:::caution
+:::warning
 
 The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugin-methods/lifecycle-apis.mdx b/website/versioned_docs/version-2.1.0/api/plugin-methods/lifecycle-apis.mdx
index 050bd5870b13..4d0dad6521e2 100644
--- a/website/versioned_docs/version-2.1.0/api/plugin-methods/lifecycle-apis.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugin-methods/lifecycle-apis.mdx
@@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro
 
 This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks.
 
-:::caution
+:::warning
 
 Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible.
 
@@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) {
 
 Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument.
 
-:::caution
+:::warning
 
 The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`)
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugins/plugin-client-redirects.mdx b/website/versioned_docs/version-2.1.0/api/plugins/plugin-client-redirects.mdx
index 8e6bd08173f2..2f5c29d7761f 100644
--- a/website/versioned_docs/version-2.1.0/api/plugins/plugin-client-redirects.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugins/plugin-client-redirects.mdx
@@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**.
 
 This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
 :::
 
-:::caution
+:::warning
 
 It is better to use server-side redirects whenever possible.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugins/plugin-content-blog.mdx b/website/versioned_docs/version-2.1.0/api/plugins/plugin-content-blog.mdx
index b20a58284bc5..72179a2c00bb 100644
--- a/website/versioned_docs/version-2.1.0/api/plugins/plugin-content-blog.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugins/plugin-content-blog.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.
 
-:::caution some features production only
+:::warning some features production only
 
 The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-analytics.mdx b/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-analytics.mdx
index b3b77732b442..33a5d2bf79bd 100644
--- a/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-analytics.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-analytics.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 The default [Google Analytics](https://developers.google.com/analytics/devguides/collection/analyticsjs/) plugin. It is a JavaScript library for measuring how users interact with your website **in the production build**. If you are using Google Analytics 4 you might need to consider using [plugin-google-gtag](./plugin-google-gtag.mdx) instead.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-gtag.mdx b/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-gtag.mdx
index fca251edd3bb..7eb16e0dd11d 100644
--- a/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-gtag.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugins/plugin-google-gtag.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugins/plugin-pwa.mdx b/website/versioned_docs/version-2.1.0/api/plugins/plugin-pwa.mdx
index b6c2b287e186..2f96eddffa71 100644
--- a/website/versioned_docs/version-2.1.0/api/plugins/plugin-pwa.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugins/plugin-pwa.mdx
@@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th
 
 After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content.
 
-:::caution
+:::warning
 
 Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites.
 
@@ -124,7 +124,7 @@ Strategies used to turn the offline mode on:
 - `saveData`: activates for users with `navigator.connection.saveData === true`
 - `always`: activates for all users
 
-:::caution
+:::warning
 
 Use this carefully: some users may not like to be forced to use the offline mode.
 
diff --git a/website/versioned_docs/version-2.1.0/api/plugins/plugin-sitemap.mdx b/website/versioned_docs/version-2.1.0/api/plugins/plugin-sitemap.mdx
index 8bf823bc429f..0d6b72763c03 100644
--- a/website/versioned_docs/version-2.1.0/api/plugins/plugin-sitemap.mdx
+++ b/website/versioned_docs/version-2.1.0/api/plugins/plugin-sitemap.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
diff --git a/website/versioned_docs/version-2.1.0/api/themes/overview.mdx b/website/versioned_docs/version-2.1.0/api/themes/overview.mdx
index 4bb78e7ff0b1..98084d7418cc 100644
--- a/website/versioned_docs/version-2.1.0/api/themes/overview.mdx
+++ b/website/versioned_docs/version-2.1.0/api/themes/overview.mdx
@@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co
 - [@docusaurus/theme-classic](./theme-classic.mdx)
 - 🚧 other themes are planned
 
-:::caution
+:::warning
 
 The goal is to have all themes share the exact same features, user-experience and configuration.
 
diff --git a/website/versioned_docs/version-2.1.0/api/themes/theme-configuration.mdx b/website/versioned_docs/version-2.1.0/api/themes/theme-configuration.mdx
index 90259d778137..2247d5417297 100644
--- a/website/versioned_docs/version-2.1.0/api/themes/theme-configuration.mdx
+++ b/website/versioned_docs/version-2.1.0/api/themes/theme-configuration.mdx
@@ -51,7 +51,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences.
 
diff --git a/website/versioned_docs/version-2.1.0/blog.mdx b/website/versioned_docs/version-2.1.0/blog.mdx
index 66d728ddf91a..ace263ad736e 100644
--- a/website/versioned_docs/version-2.1.0/blog.mdx
+++ b/website/versioned_docs/version-2.1.0/blog.mdx
@@ -365,7 +365,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml
 
 An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect.
 
-:::caution Feed generation
+:::warning Feed generation
 
 [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed.
 
@@ -590,7 +590,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.1.0/browser-support.mdx b/website/versioned_docs/version-2.1.0/browser-support.mdx
index 404601d8f45e..79c01861d705 100644
--- a/website/versioned_docs/version-2.1.0/browser-support.mdx
+++ b/website/versioned_docs/version-2.1.0/browser-support.mdx
@@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th
 
 The browser list by default is provided through the `package.json` file as a root `browserslist` field.
 
-:::caution
+:::warning
 
 On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS.
 
diff --git a/website/versioned_docs/version-2.1.0/cli.mdx b/website/versioned_docs/version-2.1.0/cli.mdx
index 2f57a03ba0d8..1923f1cc97ac 100644
--- a/website/versioned_docs/version-2.1.0/cli.mdx
+++ b/website/versioned_docs/version-2.1.0/cli.mdx
@@ -45,7 +45,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https
 | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). |
 | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
-:::important
+:::info
 
 Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production.
 
@@ -123,7 +123,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro
 | `--danger`      | Allow immediate swizzling of unsafe components        |
 | `--typescript`  | Swizzle the TypeScript variant component              |
 
-:::caution
+:::warning
 
 Unsafe components have a higher risk of breaking changes due to internal refactorings.
 
diff --git a/website/versioned_docs/version-2.1.0/deployment.mdx b/website/versioned_docs/version-2.1.0/deployment.mdx
index 3a20f0b64b1b..f1007b91e753 100644
--- a/website/versioned_docs/version-2.1.0/deployment.mdx
+++ b/website/versioned_docs/version-2.1.0/deployment.mdx
@@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings
 
 Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`.
 
-:::caution
+:::warning
 
 Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites):
 
@@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params:
 
 These fields also have their environment variable counterparts, which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`.
 
-:::caution
+:::warning
 
 GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`).
 
@@ -334,7 +334,7 @@ cmd /C 'set "GIT_USER=<GITHUB_USERNAME>" && yarn deploy'
 </Tabs>
 ```
 
-:::caution
+:::warning
 
 Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information.
 
diff --git a/website/versioned_docs/version-2.1.0/docusaurus-core.mdx b/website/versioned_docs/version-2.1.0/docusaurus-core.mdx
index 409a6082c9d7..12ba618d86c0 100644
--- a/website/versioned_docs/version-2.1.0/docusaurus-core.mdx
+++ b/website/versioned_docs/version-2.1.0/docusaurus-core.mdx
@@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client-
 
 - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout.
 
-:::caution
+:::warning
 
 The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback.
 
@@ -405,7 +405,7 @@ The `siteConfig` object only contains **serializable values** (values that are p
 
 Returns `true` when the React app has successfully hydrated in the browser.
 
-:::caution
+:::warning
 
 Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic.
 
@@ -431,7 +431,7 @@ const MyComponent = () => {
 
 React hook to prepend your site `baseUrl` to a string.
 
-:::caution
+:::warning
 
 **Don't use it for regular links!**
 
@@ -691,7 +691,7 @@ export default function Home() {
 
 A module that exposes a few boolean variables to check the current rendering environment.
 
-:::caution
+:::warning
 
 For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [`<BrowserOnly>`](#browseronly) instead.
 
diff --git a/website/versioned_docs/version-2.1.0/guides/creating-pages.mdx b/website/versioned_docs/version-2.1.0/guides/creating-pages.mdx
index 30ffdb9faf68..ce32424a2544 100644
--- a/website/versioned_docs/version-2.1.0/guides/creating-pages.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/creating-pages.mdx
@@ -129,7 +129,7 @@ my-website
 .
 ```
 
-:::caution
+:::warning
 
 All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages).
 
diff --git a/website/versioned_docs/version-2.1.0/guides/docs/docs-introduction.mdx b/website/versioned_docs/version-2.1.0/guides/docs/docs-introduction.mdx
index 250342e26b80..6e27e6be7705 100644
--- a/website/versioned_docs/version-2.1.0/guides/docs/docs-introduction.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/docs/docs-introduction.mdx
@@ -95,7 +95,7 @@ slug: /
 This page will be the home page when users visit https://example.com/.
 ```
 
-:::caution
+:::warning
 
 If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.1.0/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-2.1.0/guides/docs/docs-multi-instance.mdx
index c1acd0195b68..d9934e3bcebd 100644
--- a/website/versioned_docs/version-2.1.0/guides/docs/docs-multi-instance.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/docs/docs-multi-instance.mdx
@@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations:
 
 In this case, you can use a distinct docs plugin instance per mobile SDK documentation.
 
-:::caution
+:::warning
 
 If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites.
 
@@ -55,7 +55,7 @@ Suppose you have 2 documentations:
 
 In this case, you should use the same plugin twice in your site configuration.
 
-:::caution
+:::warning
 
 `@docusaurus/preset-classic` already includes a docs plugin instance for you!
 
diff --git a/website/versioned_docs/version-2.1.0/guides/docs/sidebar/autogenerated.mdx b/website/versioned_docs/version-2.1.0/guides/docs/sidebar/autogenerated.mdx
index c489689dc6ec..4ac6fa6e620f 100644
--- a/website/versioned_docs/version-2.1.0/guides/docs/sidebar/autogenerated.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/docs/sidebar/autogenerated.mdx
@@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat
 
 By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths.
 
-:::caution
+:::warning
 
 **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**.
 
diff --git a/website/versioned_docs/version-2.1.0/guides/docs/sidebar/items.mdx b/website/versioned_docs/version-2.1.0/guides/docs/sidebar/items.mdx
index b2793826f98b..52f62b830133 100644
--- a/website/versioned_docs/version-2.1.0/guides/docs/sidebar/items.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/docs/sidebar/items.mdx
@@ -398,7 +398,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded.
 
diff --git a/website/versioned_docs/version-2.1.0/guides/docs/versioning.mdx b/website/versioned_docs/version-2.1.0/guides/docs/versioning.mdx
index df27a964f07f..2b5657f48d81 100644
--- a/website/versioned_docs/version-2.1.0/guides/docs/versioning.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/docs/versioning.mdx
@@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ```
 
-:::caution
+:::warning
 
 Think about it before starting to version your documentation - it can become difficult for contributors to help improve it!
 
diff --git a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-code-blocks.mdx
index 1871536619bd..cccf4f45e3f8 100644
--- a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if
 
 By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23).
 
-:::caution
+:::warning
 
 Some popular languages like Java, C#, or PHP are not enabled by default.
 
@@ -510,7 +510,7 @@ function Clock(props) {
 
 ### Imports {#imports}
 
-:::caution react-live and imports
+:::warning react-live and imports
 
 It is not possible to import components directly from the react-live code editor, you have to define available imports upfront.
 
@@ -642,13 +642,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use
   </pre>
 </BrowserWindow>
 
-:::caution MDX is whitespace insensitive
+:::warning MDX is whitespace insensitive
 
 MDX is in line with JSX behavior: line break characters, even when inside `<pre>`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-intro.mdx
index 30212e50042f..643f621c5b76 100644
--- a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-intro.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-intro.mdx
@@ -12,7 +12,7 @@ Documentation is one of your product's interfaces with your users. A well-writte
 
 Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users.
 
-:::important
+:::info
 
 This section assumes you are using the official Docusaurus content plugins.
 
diff --git a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-math-equations.mdx
index 631a9dbaa5d3..cb218c280cc4 100644
--- a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@3 rehype-katex@5 hast-util-is-element@1.1.0
 ```
 
-:::caution
+:::warning
 
 Use the exact same versions. The latest versions are incompatible with Docusaurus 2.
 
diff --git a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-react.mdx
index da8e9fd86be0..ba8b213e386f 100644
--- a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-react.mdx
@@ -72,7 +72,7 @@ I can write **Markdown** alongside my _JSX_!
 </BrowserWindow>
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -202,7 +202,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [a wrapper provider](https://mdx-git-renovate-babel-monorepo-mdx.vercel.app/advanced/components#mdxprovider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -525,7 +525,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f2559..bfc161c542ee 100644
--- a/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/versioned_docs/version-2.1.0/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/versioned_docs/version-2.1.0/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.1.0/i18n/i18n-crowdin.mdx
index bd0306091f62..011b332d4ab6 100644
--- a/website/versioned_docs/version-2.1.0/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-2.1.0/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -393,7 +393,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -442,7 +442,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/versioned_docs/version-2.1.0/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-2.1.0/i18n/i18n-tutorial.mdx
index 1cdd4e6e4bc0..de7c22845af1 100644
--- a/website/versioned_docs/version-2.1.0/i18n/i18n-tutorial.mdx
+++ b/website/versioned_docs/version-2.1.0/i18n/i18n-tutorial.mdx
@@ -88,7 +88,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -115,7 +115,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `<Translate>` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`<option>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)) would [coerce it to a string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString), which returns `"[object Object]"`. While we encourage you to use `<Translate>` as JSX children, only use the element form when it actually works.
 
@@ -224,7 +224,7 @@ Most documentation websites are generally **static** and don't need advanced i18
 
 The `docusaurus write-translations` command will statically analyze all React code files used in your site, extract calls to these APIs, and aggregate them in the `code.json` file. The translation files will be stored as maps from IDs to translation message objects (including the translated label and the description of the label). In your calls to the translation APIs (`<Translate>` or `translate()`), you need to specify either the default untranslated message or the ID, in order for Docusaurus to correctly correlate each translation entry to the API call.
 
-:::caution text labels must be static
+:::warning text labels must be static
 
 The `docusaurus write-translations` command only does **static analysis** of your code. It doesn't actually run your site. Therefore, dynamic messages can't be extracted, as the message is an _expression_, not a _string_:
 
@@ -420,7 +420,7 @@ cp -r src/pages/**.md i18n/fr/docusaurus-plugin-content-pages
 cp -r src/pages/**.mdx i18n/fr/docusaurus-plugin-content-pages
 ```
 
-:::caution
+:::warning
 
 We only copy `.md` and `.mdx` files, as React pages are translated through JSON translation files already.
 
@@ -495,7 +495,7 @@ On your [static hosting provider](../deployment.mdx):
 - configure the appropriate build command, using the `--locale` option
 - configure the (sub)domain of your choice for each deployment
 
-:::caution
+:::warning
 
 This strategy is **not possible** with GitHub Pages, as it is only possible to **have a single deployment**.
 
diff --git a/website/versioned_docs/version-2.1.0/migration/migration-manual.mdx b/website/versioned_docs/version-2.1.0/migration/migration-manual.mdx
index 517d158f199e..64eed5c20e7e 100644
--- a/website/versioned_docs/version-2.1.0/migration/migration-manual.mdx
+++ b/website/versioned_docs/version-2.1.0/migration/migration-manual.mdx
@@ -293,7 +293,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Your Algolia DocSearch v1 config (found [here](https://github.com/algolia/docsearch-configs/blob/master/configs)) should be updated for Docusaurus v2 ([example](https://github.com/algolia/docsearch-configs/tree/master/configs/docusaurus-2.json)).
 
diff --git a/website/versioned_docs/version-2.1.0/migration/migration-translated-sites.mdx b/website/versioned_docs/version-2.1.0/migration/migration-translated-sites.mdx
index 57aa277974c2..ddc48fd3b820 100644
--- a/website/versioned_docs/version-2.1.0/migration/migration-translated-sites.mdx
+++ b/website/versioned_docs/version-2.1.0/migration/migration-translated-sites.mdx
@@ -70,7 +70,7 @@ This section will help you figure out how to **keep your existing v1 translation
 
 There are **multiple possible strategies** to migrate a Docusaurus v1 site using Crowdin, with different tradeoffs.
 
-:::caution
+:::warning
 
 This documentation is a best-effort to help you migrate, please help us improve it if you find a better way!
 
@@ -150,7 +150,7 @@ Crowdin has an "upload translations" feature, but in our experience it does not
 
 If you don't mind modifying your existing Crowdin project and risking to mess things up, it may be possible to use the Crowdin branch system.
 
-:::caution
+:::warning
 
 This workflow has not been tested in practice, please report us how good it is.
 
diff --git a/website/versioned_docs/version-2.1.0/search.mdx b/website/versioned_docs/version-2.1.0/search.mdx
index c1dad98ff9a8..bc08bb664224 100644
--- a/website/versioned_docs/version-2.1.0/search.mdx
+++ b/website/versioned_docs/version-2.1.0/search.mdx
@@ -125,7 +125,7 @@ Refer to its [official DocSearch documentation](https://docsearch.algolia.com/do
 
 :::
 
-:::caution
+:::warning
 
 The search feature will not work reliably until Algolia crawls your site.
 
diff --git a/website/versioned_docs/version-2.1.0/seo.mdx b/website/versioned_docs/version-2.1.0/seo.mdx
index c6a2cfd78521..ea09f87d4ae8 100644
--- a/website/versioned_docs/version-2.1.0/seo.mdx
+++ b/website/versioned_docs/version-2.1.0/seo.mdx
@@ -122,7 +122,7 @@ Disallow:
 
 Read more about the robots file in [the Google documentation](https://developers.google.com/search/docs/advanced/robots/intro).
 
-:::caution
+:::warning
 
 **Important**: the `robots.txt` file does **not** prevent HTML pages from being indexed.
 
diff --git a/website/versioned_docs/version-2.1.0/static-assets.mdx b/website/versioned_docs/version-2.1.0/static-assets.mdx
index eb9d319b3c87..29efce9e6cd3 100644
--- a/website/versioned_docs/version-2.1.0/static-assets.mdx
+++ b/website/versioned_docs/version-2.1.0/static-assets.mdx
@@ -69,7 +69,7 @@ You write a link like this: [Download this document](/files/note.docx)
 Docusaurus changes that to: <a href={require('static/files/note.docx')}>Download this document</a>
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `<a>` / `<img>`, nothing will be done.
 
diff --git a/website/versioned_docs/version-2.1.0/styling-layout.mdx b/website/versioned_docs/version-2.1.0/styling-layout.mdx
index d11c8ab07498..289aafa20575 100644
--- a/website/versioned_docs/version-2.1.0/styling-layout.mdx
+++ b/website/versioned_docs/version-2.1.0/styling-layout.mdx
@@ -178,7 +178,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/versioned_docs/version-2.1.0/swizzling.mdx b/website/versioned_docs/version-2.1.0/swizzling.mdx
index dcddfbe07864..21ef6eb1d0d5 100644
--- a/website/versioned_docs/version-2.1.0/swizzling.mdx
+++ b/website/versioned_docs/version-2.1.0/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.
 
diff --git a/website/versioned_docs/version-2.2.0/advanced/client.mdx b/website/versioned_docs/version-2.2.0/advanced/client.mdx
index 189faab8ba56..6a01e76346da 100644
--- a/website/versioned_docs/version-2.2.0/advanced/client.mdx
+++ b/website/versioned_docs/version-2.2.0/advanced/client.mdx
@@ -52,7 +52,7 @@ export default function CodeBlock(props) {
 
 Check the code of `@docusaurus/theme-live-codeblock` for details.
 
-:::caution
+:::warning
 
 Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`.
 
diff --git a/website/versioned_docs/version-2.2.0/advanced/ssg.mdx b/website/versioned_docs/version-2.2.0/advanced/ssg.mdx
index 7fd0724ece35..07931249bbc8 100644
--- a/website/versioned_docs/version-2.2.0/advanced/ssg.mdx
+++ b/website/versioned_docs/version-2.2.0/advanced/ssg.mdx
@@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow
 
 You may need to escape from SSR since static HTML can't display anything useful without knowing the client state.
 
-:::caution
+:::warning
 
 It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements.
 
diff --git a/website/versioned_docs/version-2.2.0/api/docusaurus.config.js.mdx b/website/versioned_docs/version-2.2.0/api/docusaurus.config.js.mdx
index 0601b2e39ef7..33e5cd6c6f11 100644
--- a/website/versioned_docs/version-2.2.0/api/docusaurus.config.js.mdx
+++ b/website/versioned_docs/version-2.2.0/api/docusaurus.config.js.mdx
@@ -589,7 +589,7 @@ module.exports = {
 
 ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png)
 
-:::caution
+:::warning
 
 This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL.
 
diff --git a/website/versioned_docs/version-2.2.0/api/misc/create-docusaurus.mdx b/website/versioned_docs/version-2.2.0/api/misc/create-docusaurus.mdx
index b4dc0491e4a8..039145e1dfc5 100644
--- a/website/versioned_docs/version-2.2.0/api/misc/create-docusaurus.mdx
+++ b/website/versioned_docs/version-2.2.0/api/misc/create-docusaurus.mdx
@@ -24,7 +24,7 @@ The `template` argument can be one of the following:
 
 The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD.
 
-:::caution
+:::warning
 
 This command should be preferably used in an interactive shell so all features are available.
 
diff --git a/website/versioned_docs/version-2.2.0/api/misc/logger/logger.mdx b/website/versioned_docs/version-2.2.0/api/misc/logger/logger.mdx
index 04800ed25b78..18ecf3ef07b1 100644
--- a/website/versioned_docs/version-2.2.0/api/misc/logger/logger.mdx
+++ b/website/versioned_docs/version-2.2.0/api/misc/logger/logger.mdx
@@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi
   - `success`: prints a success message.
 - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity.
 
-:::caution A word on the `error` formatter
+:::warning A word on the `error` formatter
 
 Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugin-methods/README.mdx b/website/versioned_docs/version-2.2.0/api/plugin-methods/README.mdx
index 970af327d0df..77ce21e5f955 100644
--- a/website/versioned_docs/version-2.2.0/api/plugin-methods/README.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugin-methods/README.mdx
@@ -1,6 +1,6 @@
 # Plugin Method References
 
-:::caution
+:::warning
 
 This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugin-methods/extend-infrastructure.mdx b/website/versioned_docs/version-2.2.0/api/plugin-methods/extend-infrastructure.mdx
index 1885129b7007..339490376945 100644
--- a/website/versioned_docs/version-2.2.0/api/plugin-methods/extend-infrastructure.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugin-methods/extend-infrastructure.mdx
@@ -33,7 +33,7 @@ module.exports = function (context, options) {
 
 Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object.
 
-:::caution
+:::warning
 
 The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugin-methods/lifecycle-apis.mdx b/website/versioned_docs/version-2.2.0/api/plugin-methods/lifecycle-apis.mdx
index 050bd5870b13..4d0dad6521e2 100644
--- a/website/versioned_docs/version-2.2.0/api/plugin-methods/lifecycle-apis.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugin-methods/lifecycle-apis.mdx
@@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro
 
 This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks.
 
-:::caution
+:::warning
 
 Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible.
 
@@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) {
 
 Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument.
 
-:::caution
+:::warning
 
 The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`)
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugins/plugin-client-redirects.mdx b/website/versioned_docs/version-2.2.0/api/plugins/plugin-client-redirects.mdx
index 8e6bd08173f2..2f5c29d7761f 100644
--- a/website/versioned_docs/version-2.2.0/api/plugins/plugin-client-redirects.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugins/plugin-client-redirects.mdx
@@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**.
 
 This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
 :::
 
-:::caution
+:::warning
 
 It is better to use server-side redirects whenever possible.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugins/plugin-content-blog.mdx b/website/versioned_docs/version-2.2.0/api/plugins/plugin-content-blog.mdx
index b20a58284bc5..72179a2c00bb 100644
--- a/website/versioned_docs/version-2.2.0/api/plugins/plugin-content-blog.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugins/plugin-content-blog.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.
 
-:::caution some features production only
+:::warning some features production only
 
 The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-analytics.mdx b/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-analytics.mdx
index b3b77732b442..33a5d2bf79bd 100644
--- a/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-analytics.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-analytics.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 The default [Google Analytics](https://developers.google.com/analytics/devguides/collection/analyticsjs/) plugin. It is a JavaScript library for measuring how users interact with your website **in the production build**. If you are using Google Analytics 4 you might need to consider using [plugin-google-gtag](./plugin-google-gtag.mdx) instead.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-gtag.mdx b/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-gtag.mdx
index fca251edd3bb..7eb16e0dd11d 100644
--- a/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-gtag.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugins/plugin-google-gtag.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugins/plugin-pwa.mdx b/website/versioned_docs/version-2.2.0/api/plugins/plugin-pwa.mdx
index b6c2b287e186..2f96eddffa71 100644
--- a/website/versioned_docs/version-2.2.0/api/plugins/plugin-pwa.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugins/plugin-pwa.mdx
@@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th
 
 After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content.
 
-:::caution
+:::warning
 
 Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites.
 
@@ -124,7 +124,7 @@ Strategies used to turn the offline mode on:
 - `saveData`: activates for users with `navigator.connection.saveData === true`
 - `always`: activates for all users
 
-:::caution
+:::warning
 
 Use this carefully: some users may not like to be forced to use the offline mode.
 
diff --git a/website/versioned_docs/version-2.2.0/api/plugins/plugin-sitemap.mdx b/website/versioned_docs/version-2.2.0/api/plugins/plugin-sitemap.mdx
index 8bf823bc429f..0d6b72763c03 100644
--- a/website/versioned_docs/version-2.2.0/api/plugins/plugin-sitemap.mdx
+++ b/website/versioned_docs/version-2.2.0/api/plugins/plugin-sitemap.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
diff --git a/website/versioned_docs/version-2.2.0/api/themes/overview.mdx b/website/versioned_docs/version-2.2.0/api/themes/overview.mdx
index 4bb78e7ff0b1..98084d7418cc 100644
--- a/website/versioned_docs/version-2.2.0/api/themes/overview.mdx
+++ b/website/versioned_docs/version-2.2.0/api/themes/overview.mdx
@@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co
 - [@docusaurus/theme-classic](./theme-classic.mdx)
 - 🚧 other themes are planned
 
-:::caution
+:::warning
 
 The goal is to have all themes share the exact same features, user-experience and configuration.
 
diff --git a/website/versioned_docs/version-2.2.0/api/themes/theme-configuration.mdx b/website/versioned_docs/version-2.2.0/api/themes/theme-configuration.mdx
index 90259d778137..2247d5417297 100644
--- a/website/versioned_docs/version-2.2.0/api/themes/theme-configuration.mdx
+++ b/website/versioned_docs/version-2.2.0/api/themes/theme-configuration.mdx
@@ -51,7 +51,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences.
 
diff --git a/website/versioned_docs/version-2.2.0/blog.mdx b/website/versioned_docs/version-2.2.0/blog.mdx
index 66d728ddf91a..ace263ad736e 100644
--- a/website/versioned_docs/version-2.2.0/blog.mdx
+++ b/website/versioned_docs/version-2.2.0/blog.mdx
@@ -365,7 +365,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml
 
 An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect.
 
-:::caution Feed generation
+:::warning Feed generation
 
 [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed.
 
@@ -590,7 +590,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.2.0/browser-support.mdx b/website/versioned_docs/version-2.2.0/browser-support.mdx
index 404601d8f45e..79c01861d705 100644
--- a/website/versioned_docs/version-2.2.0/browser-support.mdx
+++ b/website/versioned_docs/version-2.2.0/browser-support.mdx
@@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th
 
 The browser list by default is provided through the `package.json` file as a root `browserslist` field.
 
-:::caution
+:::warning
 
 On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS.
 
diff --git a/website/versioned_docs/version-2.2.0/cli.mdx b/website/versioned_docs/version-2.2.0/cli.mdx
index 02321c3889f9..aaa652a48d5a 100644
--- a/website/versioned_docs/version-2.2.0/cli.mdx
+++ b/website/versioned_docs/version-2.2.0/cli.mdx
@@ -45,7 +45,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https
 | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). |
 | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
-:::important
+:::info
 
 Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production.
 
@@ -124,7 +124,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro
 | `--typescript` | Swizzle the TypeScript variant component |
 | `--config` | Path to docusaurus config file, default to `[siteDir]/docusaurus.config.js` |
 
-:::caution
+:::warning
 
 Unsafe components have a higher risk of breaking changes due to internal refactorings.
 
diff --git a/website/versioned_docs/version-2.2.0/deployment.mdx b/website/versioned_docs/version-2.2.0/deployment.mdx
index 3a20f0b64b1b..f1007b91e753 100644
--- a/website/versioned_docs/version-2.2.0/deployment.mdx
+++ b/website/versioned_docs/version-2.2.0/deployment.mdx
@@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings
 
 Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`.
 
-:::caution
+:::warning
 
 Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites):
 
@@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params:
 
 These fields also have their environment variable counterparts, which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`.
 
-:::caution
+:::warning
 
 GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`).
 
@@ -334,7 +334,7 @@ cmd /C 'set "GIT_USER=<GITHUB_USERNAME>" && yarn deploy'
 </Tabs>
 ```
 
-:::caution
+:::warning
 
 Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information.
 
diff --git a/website/versioned_docs/version-2.2.0/docusaurus-core.mdx b/website/versioned_docs/version-2.2.0/docusaurus-core.mdx
index 409a6082c9d7..12ba618d86c0 100644
--- a/website/versioned_docs/version-2.2.0/docusaurus-core.mdx
+++ b/website/versioned_docs/version-2.2.0/docusaurus-core.mdx
@@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client-
 
 - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout.
 
-:::caution
+:::warning
 
 The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback.
 
@@ -405,7 +405,7 @@ The `siteConfig` object only contains **serializable values** (values that are p
 
 Returns `true` when the React app has successfully hydrated in the browser.
 
-:::caution
+:::warning
 
 Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic.
 
@@ -431,7 +431,7 @@ const MyComponent = () => {
 
 React hook to prepend your site `baseUrl` to a string.
 
-:::caution
+:::warning
 
 **Don't use it for regular links!**
 
@@ -691,7 +691,7 @@ export default function Home() {
 
 A module that exposes a few boolean variables to check the current rendering environment.
 
-:::caution
+:::warning
 
 For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [`<BrowserOnly>`](#browseronly) instead.
 
diff --git a/website/versioned_docs/version-2.2.0/guides/creating-pages.mdx b/website/versioned_docs/version-2.2.0/guides/creating-pages.mdx
index 30ffdb9faf68..ce32424a2544 100644
--- a/website/versioned_docs/version-2.2.0/guides/creating-pages.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/creating-pages.mdx
@@ -129,7 +129,7 @@ my-website
 .
 ```
 
-:::caution
+:::warning
 
 All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages).
 
diff --git a/website/versioned_docs/version-2.2.0/guides/docs/docs-introduction.mdx b/website/versioned_docs/version-2.2.0/guides/docs/docs-introduction.mdx
index 250342e26b80..6e27e6be7705 100644
--- a/website/versioned_docs/version-2.2.0/guides/docs/docs-introduction.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/docs/docs-introduction.mdx
@@ -95,7 +95,7 @@ slug: /
 This page will be the home page when users visit https://example.com/.
 ```
 
-:::caution
+:::warning
 
 If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.2.0/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-2.2.0/guides/docs/docs-multi-instance.mdx
index c1acd0195b68..d9934e3bcebd 100644
--- a/website/versioned_docs/version-2.2.0/guides/docs/docs-multi-instance.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/docs/docs-multi-instance.mdx
@@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations:
 
 In this case, you can use a distinct docs plugin instance per mobile SDK documentation.
 
-:::caution
+:::warning
 
 If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites.
 
@@ -55,7 +55,7 @@ Suppose you have 2 documentations:
 
 In this case, you should use the same plugin twice in your site configuration.
 
-:::caution
+:::warning
 
 `@docusaurus/preset-classic` already includes a docs plugin instance for you!
 
diff --git a/website/versioned_docs/version-2.2.0/guides/docs/sidebar/autogenerated.mdx b/website/versioned_docs/version-2.2.0/guides/docs/sidebar/autogenerated.mdx
index c489689dc6ec..4ac6fa6e620f 100644
--- a/website/versioned_docs/version-2.2.0/guides/docs/sidebar/autogenerated.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/docs/sidebar/autogenerated.mdx
@@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat
 
 By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths.
 
-:::caution
+:::warning
 
 **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**.
 
diff --git a/website/versioned_docs/version-2.2.0/guides/docs/sidebar/items.mdx b/website/versioned_docs/version-2.2.0/guides/docs/sidebar/items.mdx
index b2793826f98b..52f62b830133 100644
--- a/website/versioned_docs/version-2.2.0/guides/docs/sidebar/items.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/docs/sidebar/items.mdx
@@ -398,7 +398,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded.
 
diff --git a/website/versioned_docs/version-2.2.0/guides/docs/versioning.mdx b/website/versioned_docs/version-2.2.0/guides/docs/versioning.mdx
index df27a964f07f..2b5657f48d81 100644
--- a/website/versioned_docs/version-2.2.0/guides/docs/versioning.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/docs/versioning.mdx
@@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ```
 
-:::caution
+:::warning
 
 Think about it before starting to version your documentation - it can become difficult for contributors to help improve it!
 
diff --git a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-code-blocks.mdx
index 1871536619bd..cccf4f45e3f8 100644
--- a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if
 
 By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23).
 
-:::caution
+:::warning
 
 Some popular languages like Java, C#, or PHP are not enabled by default.
 
@@ -510,7 +510,7 @@ function Clock(props) {
 
 ### Imports {#imports}
 
-:::caution react-live and imports
+:::warning react-live and imports
 
 It is not possible to import components directly from the react-live code editor, you have to define available imports upfront.
 
@@ -642,13 +642,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use
   </pre>
 </BrowserWindow>
 
-:::caution MDX is whitespace insensitive
+:::warning MDX is whitespace insensitive
 
 MDX is in line with JSX behavior: line break characters, even when inside `<pre>`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-intro.mdx
index 30212e50042f..643f621c5b76 100644
--- a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-intro.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-intro.mdx
@@ -12,7 +12,7 @@ Documentation is one of your product's interfaces with your users. A well-writte
 
 Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users.
 
-:::important
+:::info
 
 This section assumes you are using the official Docusaurus content plugins.
 
diff --git a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-math-equations.mdx
index 631a9dbaa5d3..cb218c280cc4 100644
--- a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@3 rehype-katex@5 hast-util-is-element@1.1.0
 ```
 
-:::caution
+:::warning
 
 Use the exact same versions. The latest versions are incompatible with Docusaurus 2.
 
diff --git a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-react.mdx
index 898208953d45..df7b70fc9fff 100644
--- a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-react.mdx
@@ -72,7 +72,7 @@ I can write **Markdown** alongside my _JSX_!
 </BrowserWindow>
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -202,7 +202,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [a wrapper provider](https://mdx-git-renovate-babel-monorepo-mdx.vercel.app/advanced/components#mdxprovider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -525,7 +525,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f2559..bfc161c542ee 100644
--- a/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/versioned_docs/version-2.2.0/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/versioned_docs/version-2.2.0/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.2.0/i18n/i18n-crowdin.mdx
index bd0306091f62..011b332d4ab6 100644
--- a/website/versioned_docs/version-2.2.0/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-2.2.0/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -393,7 +393,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -442,7 +442,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/versioned_docs/version-2.2.0/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-2.2.0/i18n/i18n-tutorial.mdx
index 1cdd4e6e4bc0..de7c22845af1 100644
--- a/website/versioned_docs/version-2.2.0/i18n/i18n-tutorial.mdx
+++ b/website/versioned_docs/version-2.2.0/i18n/i18n-tutorial.mdx
@@ -88,7 +88,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -115,7 +115,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `<Translate>` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`<option>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)) would [coerce it to a string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString), which returns `"[object Object]"`. While we encourage you to use `<Translate>` as JSX children, only use the element form when it actually works.
 
@@ -224,7 +224,7 @@ Most documentation websites are generally **static** and don't need advanced i18
 
 The `docusaurus write-translations` command will statically analyze all React code files used in your site, extract calls to these APIs, and aggregate them in the `code.json` file. The translation files will be stored as maps from IDs to translation message objects (including the translated label and the description of the label). In your calls to the translation APIs (`<Translate>` or `translate()`), you need to specify either the default untranslated message or the ID, in order for Docusaurus to correctly correlate each translation entry to the API call.
 
-:::caution text labels must be static
+:::warning text labels must be static
 
 The `docusaurus write-translations` command only does **static analysis** of your code. It doesn't actually run your site. Therefore, dynamic messages can't be extracted, as the message is an _expression_, not a _string_:
 
@@ -420,7 +420,7 @@ cp -r src/pages/**.md i18n/fr/docusaurus-plugin-content-pages
 cp -r src/pages/**.mdx i18n/fr/docusaurus-plugin-content-pages
 ```
 
-:::caution
+:::warning
 
 We only copy `.md` and `.mdx` files, as React pages are translated through JSON translation files already.
 
@@ -495,7 +495,7 @@ On your [static hosting provider](../deployment.mdx):
 - configure the appropriate build command, using the `--locale` option
 - configure the (sub)domain of your choice for each deployment
 
-:::caution
+:::warning
 
 This strategy is **not possible** with GitHub Pages, as it is only possible to **have a single deployment**.
 
diff --git a/website/versioned_docs/version-2.2.0/migration/migration-manual.mdx b/website/versioned_docs/version-2.2.0/migration/migration-manual.mdx
index 517d158f199e..64eed5c20e7e 100644
--- a/website/versioned_docs/version-2.2.0/migration/migration-manual.mdx
+++ b/website/versioned_docs/version-2.2.0/migration/migration-manual.mdx
@@ -293,7 +293,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Your Algolia DocSearch v1 config (found [here](https://github.com/algolia/docsearch-configs/blob/master/configs)) should be updated for Docusaurus v2 ([example](https://github.com/algolia/docsearch-configs/tree/master/configs/docusaurus-2.json)).
 
diff --git a/website/versioned_docs/version-2.2.0/migration/migration-translated-sites.mdx b/website/versioned_docs/version-2.2.0/migration/migration-translated-sites.mdx
index 57aa277974c2..ddc48fd3b820 100644
--- a/website/versioned_docs/version-2.2.0/migration/migration-translated-sites.mdx
+++ b/website/versioned_docs/version-2.2.0/migration/migration-translated-sites.mdx
@@ -70,7 +70,7 @@ This section will help you figure out how to **keep your existing v1 translation
 
 There are **multiple possible strategies** to migrate a Docusaurus v1 site using Crowdin, with different tradeoffs.
 
-:::caution
+:::warning
 
 This documentation is a best-effort to help you migrate, please help us improve it if you find a better way!
 
@@ -150,7 +150,7 @@ Crowdin has an "upload translations" feature, but in our experience it does not
 
 If you don't mind modifying your existing Crowdin project and risking to mess things up, it may be possible to use the Crowdin branch system.
 
-:::caution
+:::warning
 
 This workflow has not been tested in practice, please report us how good it is.
 
diff --git a/website/versioned_docs/version-2.2.0/search.mdx b/website/versioned_docs/version-2.2.0/search.mdx
index ddef7a4a09c3..c080cd23ef58 100644
--- a/website/versioned_docs/version-2.2.0/search.mdx
+++ b/website/versioned_docs/version-2.2.0/search.mdx
@@ -125,7 +125,7 @@ Refer to its [official DocSearch documentation](https://docsearch.algolia.com/do
 
 :::
 
-:::caution
+:::warning
 
 The search feature will not work reliably until Algolia crawls your site.
 
diff --git a/website/versioned_docs/version-2.2.0/seo.mdx b/website/versioned_docs/version-2.2.0/seo.mdx
index c6a2cfd78521..ea09f87d4ae8 100644
--- a/website/versioned_docs/version-2.2.0/seo.mdx
+++ b/website/versioned_docs/version-2.2.0/seo.mdx
@@ -122,7 +122,7 @@ Disallow:
 
 Read more about the robots file in [the Google documentation](https://developers.google.com/search/docs/advanced/robots/intro).
 
-:::caution
+:::warning
 
 **Important**: the `robots.txt` file does **not** prevent HTML pages from being indexed.
 
diff --git a/website/versioned_docs/version-2.2.0/static-assets.mdx b/website/versioned_docs/version-2.2.0/static-assets.mdx
index eb9d319b3c87..29efce9e6cd3 100644
--- a/website/versioned_docs/version-2.2.0/static-assets.mdx
+++ b/website/versioned_docs/version-2.2.0/static-assets.mdx
@@ -69,7 +69,7 @@ You write a link like this: [Download this document](/files/note.docx)
 Docusaurus changes that to: <a href={require('static/files/note.docx')}>Download this document</a>
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `<a>` / `<img>`, nothing will be done.
 
diff --git a/website/versioned_docs/version-2.2.0/styling-layout.mdx b/website/versioned_docs/version-2.2.0/styling-layout.mdx
index d11c8ab07498..289aafa20575 100644
--- a/website/versioned_docs/version-2.2.0/styling-layout.mdx
+++ b/website/versioned_docs/version-2.2.0/styling-layout.mdx
@@ -178,7 +178,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/versioned_docs/version-2.2.0/swizzling.mdx b/website/versioned_docs/version-2.2.0/swizzling.mdx
index dcddfbe07864..21ef6eb1d0d5 100644
--- a/website/versioned_docs/version-2.2.0/swizzling.mdx
+++ b/website/versioned_docs/version-2.2.0/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.
 
diff --git a/website/versioned_docs/version-2.3.1/advanced/client.mdx b/website/versioned_docs/version-2.3.1/advanced/client.mdx
index 189faab8ba56..6a01e76346da 100644
--- a/website/versioned_docs/version-2.3.1/advanced/client.mdx
+++ b/website/versioned_docs/version-2.3.1/advanced/client.mdx
@@ -52,7 +52,7 @@ export default function CodeBlock(props) {
 
 Check the code of `@docusaurus/theme-live-codeblock` for details.
 
-:::caution
+:::warning
 
 Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`.
 
diff --git a/website/versioned_docs/version-2.3.1/advanced/ssg.mdx b/website/versioned_docs/version-2.3.1/advanced/ssg.mdx
index 7fd0724ece35..07931249bbc8 100644
--- a/website/versioned_docs/version-2.3.1/advanced/ssg.mdx
+++ b/website/versioned_docs/version-2.3.1/advanced/ssg.mdx
@@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow
 
 You may need to escape from SSR since static HTML can't display anything useful without knowing the client state.
 
-:::caution
+:::warning
 
 It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements.
 
diff --git a/website/versioned_docs/version-2.3.1/api/docusaurus.config.js.mdx b/website/versioned_docs/version-2.3.1/api/docusaurus.config.js.mdx
index 0601b2e39ef7..33e5cd6c6f11 100644
--- a/website/versioned_docs/version-2.3.1/api/docusaurus.config.js.mdx
+++ b/website/versioned_docs/version-2.3.1/api/docusaurus.config.js.mdx
@@ -589,7 +589,7 @@ module.exports = {
 
 ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png)
 
-:::caution
+:::warning
 
 This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL.
 
diff --git a/website/versioned_docs/version-2.3.1/api/misc/create-docusaurus.mdx b/website/versioned_docs/version-2.3.1/api/misc/create-docusaurus.mdx
index b4dc0491e4a8..039145e1dfc5 100644
--- a/website/versioned_docs/version-2.3.1/api/misc/create-docusaurus.mdx
+++ b/website/versioned_docs/version-2.3.1/api/misc/create-docusaurus.mdx
@@ -24,7 +24,7 @@ The `template` argument can be one of the following:
 
 The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD.
 
-:::caution
+:::warning
 
 This command should be preferably used in an interactive shell so all features are available.
 
diff --git a/website/versioned_docs/version-2.3.1/api/misc/logger/logger.mdx b/website/versioned_docs/version-2.3.1/api/misc/logger/logger.mdx
index 04800ed25b78..18ecf3ef07b1 100644
--- a/website/versioned_docs/version-2.3.1/api/misc/logger/logger.mdx
+++ b/website/versioned_docs/version-2.3.1/api/misc/logger/logger.mdx
@@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi
   - `success`: prints a success message.
 - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity.
 
-:::caution A word on the `error` formatter
+:::warning A word on the `error` formatter
 
 Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugin-methods/README.mdx b/website/versioned_docs/version-2.3.1/api/plugin-methods/README.mdx
index 970af327d0df..77ce21e5f955 100644
--- a/website/versioned_docs/version-2.3.1/api/plugin-methods/README.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugin-methods/README.mdx
@@ -1,6 +1,6 @@
 # Plugin Method References
 
-:::caution
+:::warning
 
 This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugin-methods/extend-infrastructure.mdx b/website/versioned_docs/version-2.3.1/api/plugin-methods/extend-infrastructure.mdx
index 1885129b7007..339490376945 100644
--- a/website/versioned_docs/version-2.3.1/api/plugin-methods/extend-infrastructure.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugin-methods/extend-infrastructure.mdx
@@ -33,7 +33,7 @@ module.exports = function (context, options) {
 
 Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object.
 
-:::caution
+:::warning
 
 The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugin-methods/lifecycle-apis.mdx b/website/versioned_docs/version-2.3.1/api/plugin-methods/lifecycle-apis.mdx
index 050bd5870b13..4d0dad6521e2 100644
--- a/website/versioned_docs/version-2.3.1/api/plugin-methods/lifecycle-apis.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugin-methods/lifecycle-apis.mdx
@@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro
 
 This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks.
 
-:::caution
+:::warning
 
 Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible.
 
@@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) {
 
 Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument.
 
-:::caution
+:::warning
 
 The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`)
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-client-redirects.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-client-redirects.mdx
index 8e6bd08173f2..2f5c29d7761f 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-client-redirects.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-client-redirects.mdx
@@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**.
 
 This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
 :::
 
-:::caution
+:::warning
 
 It is better to use server-side redirects whenever possible.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-content-blog.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-content-blog.mdx
index e6ffc4d9b01c..8afee91793bc 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-content-blog.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-content-blog.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.
 
-:::caution some features production only
+:::warning some features production only
 
 The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-analytics.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-analytics.mdx
index 97b5cc0f3fd0..555e5bea7277 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-analytics.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-analytics.mdx
@@ -19,7 +19,7 @@ If you are still using this plugin with a `UA-*` tracking id, you should create
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-gtag.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-gtag.mdx
index fca251edd3bb..7eb16e0dd11d 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-gtag.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-gtag.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-tag-manager.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-tag-manager.mdx
index bfc9d4130ad8..e1b1589db6ad 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-tag-manager.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-google-tag-manager.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-pwa.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-pwa.mdx
index b6c2b287e186..2f96eddffa71 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-pwa.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-pwa.mdx
@@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th
 
 After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content.
 
-:::caution
+:::warning
 
 Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites.
 
@@ -124,7 +124,7 @@ Strategies used to turn the offline mode on:
 - `saveData`: activates for users with `navigator.connection.saveData === true`
 - `always`: activates for all users
 
-:::caution
+:::warning
 
 Use this carefully: some users may not like to be forced to use the offline mode.
 
diff --git a/website/versioned_docs/version-2.3.1/api/plugins/plugin-sitemap.mdx b/website/versioned_docs/version-2.3.1/api/plugins/plugin-sitemap.mdx
index 8bf823bc429f..0d6b72763c03 100644
--- a/website/versioned_docs/version-2.3.1/api/plugins/plugin-sitemap.mdx
+++ b/website/versioned_docs/version-2.3.1/api/plugins/plugin-sitemap.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
diff --git a/website/versioned_docs/version-2.3.1/api/themes/overview.mdx b/website/versioned_docs/version-2.3.1/api/themes/overview.mdx
index 4bb78e7ff0b1..98084d7418cc 100644
--- a/website/versioned_docs/version-2.3.1/api/themes/overview.mdx
+++ b/website/versioned_docs/version-2.3.1/api/themes/overview.mdx
@@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co
 - [@docusaurus/theme-classic](./theme-classic.mdx)
 - 🚧 other themes are planned
 
-:::caution
+:::warning
 
 The goal is to have all themes share the exact same features, user-experience and configuration.
 
diff --git a/website/versioned_docs/version-2.3.1/api/themes/theme-configuration.mdx b/website/versioned_docs/version-2.3.1/api/themes/theme-configuration.mdx
index 90259d778137..2247d5417297 100644
--- a/website/versioned_docs/version-2.3.1/api/themes/theme-configuration.mdx
+++ b/website/versioned_docs/version-2.3.1/api/themes/theme-configuration.mdx
@@ -51,7 +51,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences.
 
diff --git a/website/versioned_docs/version-2.3.1/blog.mdx b/website/versioned_docs/version-2.3.1/blog.mdx
index cb3110859a16..82b89e30b285 100644
--- a/website/versioned_docs/version-2.3.1/blog.mdx
+++ b/website/versioned_docs/version-2.3.1/blog.mdx
@@ -365,7 +365,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml
 
 An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect.
 
-:::caution Feed generation
+:::warning Feed generation
 
 [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed.
 
@@ -609,7 +609,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.3.1/browser-support.mdx b/website/versioned_docs/version-2.3.1/browser-support.mdx
index 404601d8f45e..79c01861d705 100644
--- a/website/versioned_docs/version-2.3.1/browser-support.mdx
+++ b/website/versioned_docs/version-2.3.1/browser-support.mdx
@@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th
 
 The browser list by default is provided through the `package.json` file as a root `browserslist` field.
 
-:::caution
+:::warning
 
 On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS.
 
diff --git a/website/versioned_docs/version-2.3.1/cli.mdx b/website/versioned_docs/version-2.3.1/cli.mdx
index 02321c3889f9..aaa652a48d5a 100644
--- a/website/versioned_docs/version-2.3.1/cli.mdx
+++ b/website/versioned_docs/version-2.3.1/cli.mdx
@@ -45,7 +45,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https
 | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). |
 | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
-:::important
+:::info
 
 Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production.
 
@@ -124,7 +124,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro
 | `--typescript` | Swizzle the TypeScript variant component |
 | `--config` | Path to docusaurus config file, default to `[siteDir]/docusaurus.config.js` |
 
-:::caution
+:::warning
 
 Unsafe components have a higher risk of breaking changes due to internal refactorings.
 
diff --git a/website/versioned_docs/version-2.3.1/deployment.mdx b/website/versioned_docs/version-2.3.1/deployment.mdx
index 3a20f0b64b1b..f1007b91e753 100644
--- a/website/versioned_docs/version-2.3.1/deployment.mdx
+++ b/website/versioned_docs/version-2.3.1/deployment.mdx
@@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings
 
 Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`.
 
-:::caution
+:::warning
 
 Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites):
 
@@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params:
 
 These fields also have their environment variable counterparts, which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`.
 
-:::caution
+:::warning
 
 GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`).
 
@@ -334,7 +334,7 @@ cmd /C 'set "GIT_USER=<GITHUB_USERNAME>" && yarn deploy'
 </Tabs>
 ```
 
-:::caution
+:::warning
 
 Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information.
 
diff --git a/website/versioned_docs/version-2.3.1/docusaurus-core.mdx b/website/versioned_docs/version-2.3.1/docusaurus-core.mdx
index 409a6082c9d7..12ba618d86c0 100644
--- a/website/versioned_docs/version-2.3.1/docusaurus-core.mdx
+++ b/website/versioned_docs/version-2.3.1/docusaurus-core.mdx
@@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client-
 
 - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout.
 
-:::caution
+:::warning
 
 The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback.
 
@@ -405,7 +405,7 @@ The `siteConfig` object only contains **serializable values** (values that are p
 
 Returns `true` when the React app has successfully hydrated in the browser.
 
-:::caution
+:::warning
 
 Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic.
 
@@ -431,7 +431,7 @@ const MyComponent = () => {
 
 React hook to prepend your site `baseUrl` to a string.
 
-:::caution
+:::warning
 
 **Don't use it for regular links!**
 
@@ -691,7 +691,7 @@ export default function Home() {
 
 A module that exposes a few boolean variables to check the current rendering environment.
 
-:::caution
+:::warning
 
 For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [`<BrowserOnly>`](#browseronly) instead.
 
diff --git a/website/versioned_docs/version-2.3.1/guides/creating-pages.mdx b/website/versioned_docs/version-2.3.1/guides/creating-pages.mdx
index 30ffdb9faf68..ce32424a2544 100644
--- a/website/versioned_docs/version-2.3.1/guides/creating-pages.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/creating-pages.mdx
@@ -129,7 +129,7 @@ my-website
 .
 ```
 
-:::caution
+:::warning
 
 All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages).
 
diff --git a/website/versioned_docs/version-2.3.1/guides/docs/docs-introduction.mdx b/website/versioned_docs/version-2.3.1/guides/docs/docs-introduction.mdx
index 250342e26b80..6e27e6be7705 100644
--- a/website/versioned_docs/version-2.3.1/guides/docs/docs-introduction.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/docs/docs-introduction.mdx
@@ -95,7 +95,7 @@ slug: /
 This page will be the home page when users visit https://example.com/.
 ```
 
-:::caution
+:::warning
 
 If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.3.1/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-2.3.1/guides/docs/docs-multi-instance.mdx
index c1acd0195b68..d9934e3bcebd 100644
--- a/website/versioned_docs/version-2.3.1/guides/docs/docs-multi-instance.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/docs/docs-multi-instance.mdx
@@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations:
 
 In this case, you can use a distinct docs plugin instance per mobile SDK documentation.
 
-:::caution
+:::warning
 
 If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites.
 
@@ -55,7 +55,7 @@ Suppose you have 2 documentations:
 
 In this case, you should use the same plugin twice in your site configuration.
 
-:::caution
+:::warning
 
 `@docusaurus/preset-classic` already includes a docs plugin instance for you!
 
diff --git a/website/versioned_docs/version-2.3.1/guides/docs/sidebar/autogenerated.mdx b/website/versioned_docs/version-2.3.1/guides/docs/sidebar/autogenerated.mdx
index c489689dc6ec..4ac6fa6e620f 100644
--- a/website/versioned_docs/version-2.3.1/guides/docs/sidebar/autogenerated.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/docs/sidebar/autogenerated.mdx
@@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat
 
 By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths.
 
-:::caution
+:::warning
 
 **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**.
 
diff --git a/website/versioned_docs/version-2.3.1/guides/docs/sidebar/items.mdx b/website/versioned_docs/version-2.3.1/guides/docs/sidebar/items.mdx
index b2793826f98b..52f62b830133 100644
--- a/website/versioned_docs/version-2.3.1/guides/docs/sidebar/items.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/docs/sidebar/items.mdx
@@ -398,7 +398,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded.
 
diff --git a/website/versioned_docs/version-2.3.1/guides/docs/versioning.mdx b/website/versioned_docs/version-2.3.1/guides/docs/versioning.mdx
index df27a964f07f..2b5657f48d81 100644
--- a/website/versioned_docs/version-2.3.1/guides/docs/versioning.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/docs/versioning.mdx
@@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ```
 
-:::caution
+:::warning
 
 Think about it before starting to version your documentation - it can become difficult for contributors to help improve it!
 
diff --git a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-code-blocks.mdx
index 1871536619bd..cccf4f45e3f8 100644
--- a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if
 
 By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23).
 
-:::caution
+:::warning
 
 Some popular languages like Java, C#, or PHP are not enabled by default.
 
@@ -510,7 +510,7 @@ function Clock(props) {
 
 ### Imports {#imports}
 
-:::caution react-live and imports
+:::warning react-live and imports
 
 It is not possible to import components directly from the react-live code editor, you have to define available imports upfront.
 
@@ -642,13 +642,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use
   </pre>
 </BrowserWindow>
 
-:::caution MDX is whitespace insensitive
+:::warning MDX is whitespace insensitive
 
 MDX is in line with JSX behavior: line break characters, even when inside `<pre>`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-intro.mdx
index 30212e50042f..643f621c5b76 100644
--- a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-intro.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-intro.mdx
@@ -12,7 +12,7 @@ Documentation is one of your product's interfaces with your users. A well-writte
 
 Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users.
 
-:::important
+:::info
 
 This section assumes you are using the official Docusaurus content plugins.
 
diff --git a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-math-equations.mdx
index 631a9dbaa5d3..cb218c280cc4 100644
--- a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@3 rehype-katex@5 hast-util-is-element@1.1.0
 ```
 
-:::caution
+:::warning
 
 Use the exact same versions. The latest versions are incompatible with Docusaurus 2.
 
diff --git a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-react.mdx
index 431377b98bf6..ac2c4a2ebc94 100644
--- a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-react.mdx
@@ -72,7 +72,7 @@ I can write **Markdown** alongside my _JSX_!
 </BrowserWindow>
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -202,7 +202,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [a wrapper provider](https://mdx-git-renovate-babel-monorepo-mdx.vercel.app/advanced/components#mdxprovider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -525,7 +525,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f2559..bfc161c542ee 100644
--- a/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/versioned_docs/version-2.3.1/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/versioned_docs/version-2.3.1/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.3.1/i18n/i18n-crowdin.mdx
index bd0306091f62..011b332d4ab6 100644
--- a/website/versioned_docs/version-2.3.1/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-2.3.1/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -393,7 +393,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -442,7 +442,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/versioned_docs/version-2.3.1/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-2.3.1/i18n/i18n-tutorial.mdx
index 1cdd4e6e4bc0..de7c22845af1 100644
--- a/website/versioned_docs/version-2.3.1/i18n/i18n-tutorial.mdx
+++ b/website/versioned_docs/version-2.3.1/i18n/i18n-tutorial.mdx
@@ -88,7 +88,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -115,7 +115,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `<Translate>` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`<option>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)) would [coerce it to a string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString), which returns `"[object Object]"`. While we encourage you to use `<Translate>` as JSX children, only use the element form when it actually works.
 
@@ -224,7 +224,7 @@ Most documentation websites are generally **static** and don't need advanced i18
 
 The `docusaurus write-translations` command will statically analyze all React code files used in your site, extract calls to these APIs, and aggregate them in the `code.json` file. The translation files will be stored as maps from IDs to translation message objects (including the translated label and the description of the label). In your calls to the translation APIs (`<Translate>` or `translate()`), you need to specify either the default untranslated message or the ID, in order for Docusaurus to correctly correlate each translation entry to the API call.
 
-:::caution text labels must be static
+:::warning text labels must be static
 
 The `docusaurus write-translations` command only does **static analysis** of your code. It doesn't actually run your site. Therefore, dynamic messages can't be extracted, as the message is an _expression_, not a _string_:
 
@@ -420,7 +420,7 @@ cp -r src/pages/**.md i18n/fr/docusaurus-plugin-content-pages
 cp -r src/pages/**.mdx i18n/fr/docusaurus-plugin-content-pages
 ```
 
-:::caution
+:::warning
 
 We only copy `.md` and `.mdx` files, as React pages are translated through JSON translation files already.
 
@@ -495,7 +495,7 @@ On your [static hosting provider](../deployment.mdx):
 - configure the appropriate build command, using the `--locale` option
 - configure the (sub)domain of your choice for each deployment
 
-:::caution
+:::warning
 
 This strategy is **not possible** with GitHub Pages, as it is only possible to **have a single deployment**.
 
diff --git a/website/versioned_docs/version-2.3.1/migration/migration-manual.mdx b/website/versioned_docs/version-2.3.1/migration/migration-manual.mdx
index 517d158f199e..64eed5c20e7e 100644
--- a/website/versioned_docs/version-2.3.1/migration/migration-manual.mdx
+++ b/website/versioned_docs/version-2.3.1/migration/migration-manual.mdx
@@ -293,7 +293,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Your Algolia DocSearch v1 config (found [here](https://github.com/algolia/docsearch-configs/blob/master/configs)) should be updated for Docusaurus v2 ([example](https://github.com/algolia/docsearch-configs/tree/master/configs/docusaurus-2.json)).
 
diff --git a/website/versioned_docs/version-2.3.1/migration/migration-translated-sites.mdx b/website/versioned_docs/version-2.3.1/migration/migration-translated-sites.mdx
index 57aa277974c2..ddc48fd3b820 100644
--- a/website/versioned_docs/version-2.3.1/migration/migration-translated-sites.mdx
+++ b/website/versioned_docs/version-2.3.1/migration/migration-translated-sites.mdx
@@ -70,7 +70,7 @@ This section will help you figure out how to **keep your existing v1 translation
 
 There are **multiple possible strategies** to migrate a Docusaurus v1 site using Crowdin, with different tradeoffs.
 
-:::caution
+:::warning
 
 This documentation is a best-effort to help you migrate, please help us improve it if you find a better way!
 
@@ -150,7 +150,7 @@ Crowdin has an "upload translations" feature, but in our experience it does not
 
 If you don't mind modifying your existing Crowdin project and risking to mess things up, it may be possible to use the Crowdin branch system.
 
-:::caution
+:::warning
 
 This workflow has not been tested in practice, please report us how good it is.
 
diff --git a/website/versioned_docs/version-2.3.1/search.mdx b/website/versioned_docs/version-2.3.1/search.mdx
index 78f785bca0cb..3b260fcd7fe5 100644
--- a/website/versioned_docs/version-2.3.1/search.mdx
+++ b/website/versioned_docs/version-2.3.1/search.mdx
@@ -131,7 +131,7 @@ Refer to its [official DocSearch documentation](https://docsearch.algolia.com/do
 
 :::
 
-:::caution
+:::warning
 
 The search feature will not work reliably until Algolia crawls your site.
 
diff --git a/website/versioned_docs/version-2.3.1/seo.mdx b/website/versioned_docs/version-2.3.1/seo.mdx
index c6a2cfd78521..ea09f87d4ae8 100644
--- a/website/versioned_docs/version-2.3.1/seo.mdx
+++ b/website/versioned_docs/version-2.3.1/seo.mdx
@@ -122,7 +122,7 @@ Disallow:
 
 Read more about the robots file in [the Google documentation](https://developers.google.com/search/docs/advanced/robots/intro).
 
-:::caution
+:::warning
 
 **Important**: the `robots.txt` file does **not** prevent HTML pages from being indexed.
 
diff --git a/website/versioned_docs/version-2.3.1/static-assets.mdx b/website/versioned_docs/version-2.3.1/static-assets.mdx
index eb9d319b3c87..29efce9e6cd3 100644
--- a/website/versioned_docs/version-2.3.1/static-assets.mdx
+++ b/website/versioned_docs/version-2.3.1/static-assets.mdx
@@ -69,7 +69,7 @@ You write a link like this: [Download this document](/files/note.docx)
 Docusaurus changes that to: <a href={require('static/files/note.docx')}>Download this document</a>
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `<a>` / `<img>`, nothing will be done.
 
diff --git a/website/versioned_docs/version-2.3.1/styling-layout.mdx b/website/versioned_docs/version-2.3.1/styling-layout.mdx
index d11c8ab07498..289aafa20575 100644
--- a/website/versioned_docs/version-2.3.1/styling-layout.mdx
+++ b/website/versioned_docs/version-2.3.1/styling-layout.mdx
@@ -178,7 +178,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/versioned_docs/version-2.3.1/swizzling.mdx b/website/versioned_docs/version-2.3.1/swizzling.mdx
index dcddfbe07864..21ef6eb1d0d5 100644
--- a/website/versioned_docs/version-2.3.1/swizzling.mdx
+++ b/website/versioned_docs/version-2.3.1/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.
 
diff --git a/website/versioned_docs/version-2.4.1/advanced/client.mdx b/website/versioned_docs/version-2.4.1/advanced/client.mdx
index 189faab8ba56..6a01e76346da 100644
--- a/website/versioned_docs/version-2.4.1/advanced/client.mdx
+++ b/website/versioned_docs/version-2.4.1/advanced/client.mdx
@@ -52,7 +52,7 @@ export default function CodeBlock(props) {
 
 Check the code of `@docusaurus/theme-live-codeblock` for details.
 
-:::caution
+:::warning
 
 Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`.
 
diff --git a/website/versioned_docs/version-2.4.1/advanced/ssg.mdx b/website/versioned_docs/version-2.4.1/advanced/ssg.mdx
index 7fd0724ece35..07931249bbc8 100644
--- a/website/versioned_docs/version-2.4.1/advanced/ssg.mdx
+++ b/website/versioned_docs/version-2.4.1/advanced/ssg.mdx
@@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow
 
 You may need to escape from SSR since static HTML can't display anything useful without knowing the client state.
 
-:::caution
+:::warning
 
 It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements.
 
diff --git a/website/versioned_docs/version-2.4.1/api/docusaurus.config.js.mdx b/website/versioned_docs/version-2.4.1/api/docusaurus.config.js.mdx
index 052baa5b069b..b89c84a3c5d0 100644
--- a/website/versioned_docs/version-2.4.1/api/docusaurus.config.js.mdx
+++ b/website/versioned_docs/version-2.4.1/api/docusaurus.config.js.mdx
@@ -589,7 +589,7 @@ module.exports = {
 
 ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png)
 
-:::caution
+:::warning
 
 This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL.
 
diff --git a/website/versioned_docs/version-2.4.1/api/misc/create-docusaurus.mdx b/website/versioned_docs/version-2.4.1/api/misc/create-docusaurus.mdx
index b4dc0491e4a8..039145e1dfc5 100644
--- a/website/versioned_docs/version-2.4.1/api/misc/create-docusaurus.mdx
+++ b/website/versioned_docs/version-2.4.1/api/misc/create-docusaurus.mdx
@@ -24,7 +24,7 @@ The `template` argument can be one of the following:
 
 The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD.
 
-:::caution
+:::warning
 
 This command should be preferably used in an interactive shell so all features are available.
 
diff --git a/website/versioned_docs/version-2.4.1/api/misc/logger/logger.mdx b/website/versioned_docs/version-2.4.1/api/misc/logger/logger.mdx
index 04800ed25b78..18ecf3ef07b1 100644
--- a/website/versioned_docs/version-2.4.1/api/misc/logger/logger.mdx
+++ b/website/versioned_docs/version-2.4.1/api/misc/logger/logger.mdx
@@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi
   - `success`: prints a success message.
 - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity.
 
-:::caution A word on the `error` formatter
+:::warning A word on the `error` formatter
 
 Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugin-methods/README.mdx b/website/versioned_docs/version-2.4.1/api/plugin-methods/README.mdx
index 970af327d0df..77ce21e5f955 100644
--- a/website/versioned_docs/version-2.4.1/api/plugin-methods/README.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugin-methods/README.mdx
@@ -1,6 +1,6 @@
 # Plugin Method References
 
-:::caution
+:::warning
 
 This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugin-methods/extend-infrastructure.mdx b/website/versioned_docs/version-2.4.1/api/plugin-methods/extend-infrastructure.mdx
index 1885129b7007..339490376945 100644
--- a/website/versioned_docs/version-2.4.1/api/plugin-methods/extend-infrastructure.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugin-methods/extend-infrastructure.mdx
@@ -33,7 +33,7 @@ module.exports = function (context, options) {
 
 Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object.
 
-:::caution
+:::warning
 
 The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugin-methods/lifecycle-apis.mdx b/website/versioned_docs/version-2.4.1/api/plugin-methods/lifecycle-apis.mdx
index 050bd5870b13..4d0dad6521e2 100644
--- a/website/versioned_docs/version-2.4.1/api/plugin-methods/lifecycle-apis.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugin-methods/lifecycle-apis.mdx
@@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro
 
 This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks.
 
-:::caution
+:::warning
 
 Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible.
 
@@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) {
 
 Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument.
 
-:::caution
+:::warning
 
 The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`)
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-client-redirects.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-client-redirects.mdx
index 8e6bd08173f2..2f5c29d7761f 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-client-redirects.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-client-redirects.mdx
@@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**.
 
 This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
 :::
 
-:::caution
+:::warning
 
 It is better to use server-side redirects whenever possible.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-content-blog.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-content-blog.mdx
index e6ffc4d9b01c..8afee91793bc 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-content-blog.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-content-blog.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.
 
-:::caution some features production only
+:::warning some features production only
 
 The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-analytics.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-analytics.mdx
index 97b5cc0f3fd0..555e5bea7277 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-analytics.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-analytics.mdx
@@ -19,7 +19,7 @@ If you are still using this plugin with a `UA-*` tracking id, you should create
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-gtag.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-gtag.mdx
index dc1eeaf7b6fc..501b6c2f42c8 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-gtag.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-gtag.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-tag-manager.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-tag-manager.mdx
index bfc9d4130ad8..e1b1589db6ad 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-tag-manager.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-google-tag-manager.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-pwa.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-pwa.mdx
index b6c2b287e186..2f96eddffa71 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-pwa.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-pwa.mdx
@@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th
 
 After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content.
 
-:::caution
+:::warning
 
 Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites.
 
@@ -124,7 +124,7 @@ Strategies used to turn the offline mode on:
 - `saveData`: activates for users with `navigator.connection.saveData === true`
 - `always`: activates for all users
 
-:::caution
+:::warning
 
 Use this carefully: some users may not like to be forced to use the offline mode.
 
diff --git a/website/versioned_docs/version-2.4.1/api/plugins/plugin-sitemap.mdx b/website/versioned_docs/version-2.4.1/api/plugins/plugin-sitemap.mdx
index 8bf823bc429f..0d6b72763c03 100644
--- a/website/versioned_docs/version-2.4.1/api/plugins/plugin-sitemap.mdx
+++ b/website/versioned_docs/version-2.4.1/api/plugins/plugin-sitemap.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
diff --git a/website/versioned_docs/version-2.4.1/api/themes/overview.mdx b/website/versioned_docs/version-2.4.1/api/themes/overview.mdx
index 4bb78e7ff0b1..98084d7418cc 100644
--- a/website/versioned_docs/version-2.4.1/api/themes/overview.mdx
+++ b/website/versioned_docs/version-2.4.1/api/themes/overview.mdx
@@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co
 - [@docusaurus/theme-classic](./theme-classic.mdx)
 - 🚧 other themes are planned
 
-:::caution
+:::warning
 
 The goal is to have all themes share the exact same features, user-experience and configuration.
 
diff --git a/website/versioned_docs/version-2.4.1/api/themes/theme-configuration.mdx b/website/versioned_docs/version-2.4.1/api/themes/theme-configuration.mdx
index 90259d778137..2247d5417297 100644
--- a/website/versioned_docs/version-2.4.1/api/themes/theme-configuration.mdx
+++ b/website/versioned_docs/version-2.4.1/api/themes/theme-configuration.mdx
@@ -51,7 +51,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences.
 
diff --git a/website/versioned_docs/version-2.4.1/blog.mdx b/website/versioned_docs/version-2.4.1/blog.mdx
index cb3110859a16..82b89e30b285 100644
--- a/website/versioned_docs/version-2.4.1/blog.mdx
+++ b/website/versioned_docs/version-2.4.1/blog.mdx
@@ -365,7 +365,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml
 
 An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect.
 
-:::caution Feed generation
+:::warning Feed generation
 
 [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed.
 
@@ -609,7 +609,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.4.1/browser-support.mdx b/website/versioned_docs/version-2.4.1/browser-support.mdx
index 404601d8f45e..79c01861d705 100644
--- a/website/versioned_docs/version-2.4.1/browser-support.mdx
+++ b/website/versioned_docs/version-2.4.1/browser-support.mdx
@@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th
 
 The browser list by default is provided through the `package.json` file as a root `browserslist` field.
 
-:::caution
+:::warning
 
 On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS.
 
diff --git a/website/versioned_docs/version-2.4.1/cli.mdx b/website/versioned_docs/version-2.4.1/cli.mdx
index 02321c3889f9..aaa652a48d5a 100644
--- a/website/versioned_docs/version-2.4.1/cli.mdx
+++ b/website/versioned_docs/version-2.4.1/cli.mdx
@@ -45,7 +45,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https
 | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). |
 | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
-:::important
+:::info
 
 Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production.
 
@@ -124,7 +124,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro
 | `--typescript` | Swizzle the TypeScript variant component |
 | `--config` | Path to docusaurus config file, default to `[siteDir]/docusaurus.config.js` |
 
-:::caution
+:::warning
 
 Unsafe components have a higher risk of breaking changes due to internal refactorings.
 
diff --git a/website/versioned_docs/version-2.4.1/deployment.mdx b/website/versioned_docs/version-2.4.1/deployment.mdx
index 3a20f0b64b1b..f1007b91e753 100644
--- a/website/versioned_docs/version-2.4.1/deployment.mdx
+++ b/website/versioned_docs/version-2.4.1/deployment.mdx
@@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings
 
 Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`.
 
-:::caution
+:::warning
 
 Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites):
 
@@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params:
 
 These fields also have their environment variable counterparts, which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`.
 
-:::caution
+:::warning
 
 GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`).
 
@@ -334,7 +334,7 @@ cmd /C 'set "GIT_USER=<GITHUB_USERNAME>" && yarn deploy'
 </Tabs>
 ```
 
-:::caution
+:::warning
 
 Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information.
 
diff --git a/website/versioned_docs/version-2.4.1/docusaurus-core.mdx b/website/versioned_docs/version-2.4.1/docusaurus-core.mdx
index 409a6082c9d7..12ba618d86c0 100644
--- a/website/versioned_docs/version-2.4.1/docusaurus-core.mdx
+++ b/website/versioned_docs/version-2.4.1/docusaurus-core.mdx
@@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client-
 
 - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout.
 
-:::caution
+:::warning
 
 The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback.
 
@@ -405,7 +405,7 @@ The `siteConfig` object only contains **serializable values** (values that are p
 
 Returns `true` when the React app has successfully hydrated in the browser.
 
-:::caution
+:::warning
 
 Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic.
 
@@ -431,7 +431,7 @@ const MyComponent = () => {
 
 React hook to prepend your site `baseUrl` to a string.
 
-:::caution
+:::warning
 
 **Don't use it for regular links!**
 
@@ -691,7 +691,7 @@ export default function Home() {
 
 A module that exposes a few boolean variables to check the current rendering environment.
 
-:::caution
+:::warning
 
 For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [`<BrowserOnly>`](#browseronly) instead.
 
diff --git a/website/versioned_docs/version-2.4.1/guides/creating-pages.mdx b/website/versioned_docs/version-2.4.1/guides/creating-pages.mdx
index 30ffdb9faf68..ce32424a2544 100644
--- a/website/versioned_docs/version-2.4.1/guides/creating-pages.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/creating-pages.mdx
@@ -129,7 +129,7 @@ my-website
 .
 ```
 
-:::caution
+:::warning
 
 All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages).
 
diff --git a/website/versioned_docs/version-2.4.1/guides/docs/docs-introduction.mdx b/website/versioned_docs/version-2.4.1/guides/docs/docs-introduction.mdx
index 250342e26b80..6e27e6be7705 100644
--- a/website/versioned_docs/version-2.4.1/guides/docs/docs-introduction.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/docs/docs-introduction.mdx
@@ -95,7 +95,7 @@ slug: /
 This page will be the home page when users visit https://example.com/.
 ```
 
-:::caution
+:::warning
 
 If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-2.4.1/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-2.4.1/guides/docs/docs-multi-instance.mdx
index c1acd0195b68..d9934e3bcebd 100644
--- a/website/versioned_docs/version-2.4.1/guides/docs/docs-multi-instance.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/docs/docs-multi-instance.mdx
@@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations:
 
 In this case, you can use a distinct docs plugin instance per mobile SDK documentation.
 
-:::caution
+:::warning
 
 If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites.
 
@@ -55,7 +55,7 @@ Suppose you have 2 documentations:
 
 In this case, you should use the same plugin twice in your site configuration.
 
-:::caution
+:::warning
 
 `@docusaurus/preset-classic` already includes a docs plugin instance for you!
 
diff --git a/website/versioned_docs/version-2.4.1/guides/docs/sidebar/autogenerated.mdx b/website/versioned_docs/version-2.4.1/guides/docs/sidebar/autogenerated.mdx
index c489689dc6ec..4ac6fa6e620f 100644
--- a/website/versioned_docs/version-2.4.1/guides/docs/sidebar/autogenerated.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/docs/sidebar/autogenerated.mdx
@@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat
 
 By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths.
 
-:::caution
+:::warning
 
 **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**.
 
diff --git a/website/versioned_docs/version-2.4.1/guides/docs/sidebar/items.mdx b/website/versioned_docs/version-2.4.1/guides/docs/sidebar/items.mdx
index 1e358a12fee6..77789ebf474c 100644
--- a/website/versioned_docs/version-2.4.1/guides/docs/sidebar/items.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/docs/sidebar/items.mdx
@@ -400,7 +400,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded.
 
diff --git a/website/versioned_docs/version-2.4.1/guides/docs/versioning.mdx b/website/versioned_docs/version-2.4.1/guides/docs/versioning.mdx
index df27a964f07f..2b5657f48d81 100644
--- a/website/versioned_docs/version-2.4.1/guides/docs/versioning.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/docs/versioning.mdx
@@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ```
 
-:::caution
+:::warning
 
 Think about it before starting to version your documentation - it can become difficult for contributors to help improve it!
 
diff --git a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-code-blocks.mdx
index be4ac0b6a81a..9214382c59bd 100644
--- a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if
 
 By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23).
 
-:::caution
+:::warning
 
 Some popular languages like Java, C#, or PHP are not enabled by default.
 
@@ -510,7 +510,7 @@ function Clock(props) {
 
 ### Imports {#imports}
 
-:::caution react-live and imports
+:::warning react-live and imports
 
 It is not possible to import components directly from the react-live code editor, you have to define available imports upfront.
 
@@ -642,13 +642,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use
   </pre>
 </BrowserWindow>
 
-:::caution MDX is whitespace insensitive
+:::warning MDX is whitespace insensitive
 
 MDX is in line with JSX behavior: line break characters, even when inside `<pre>`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-intro.mdx
index 30212e50042f..643f621c5b76 100644
--- a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-intro.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-intro.mdx
@@ -12,7 +12,7 @@ Documentation is one of your product's interfaces with your users. A well-writte
 
 Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users.
 
-:::important
+:::info
 
 This section assumes you are using the official Docusaurus content plugins.
 
diff --git a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-math-equations.mdx
index 631a9dbaa5d3..cb218c280cc4 100644
--- a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@3 rehype-katex@5 hast-util-is-element@1.1.0
 ```
 
-:::caution
+:::warning
 
 Use the exact same versions. The latest versions are incompatible with Docusaurus 2.
 
diff --git a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-react.mdx
index 431377b98bf6..ac2c4a2ebc94 100644
--- a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-react.mdx
@@ -72,7 +72,7 @@ I can write **Markdown** alongside my _JSX_!
 </BrowserWindow>
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -202,7 +202,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [a wrapper provider](https://mdx-git-renovate-babel-monorepo-mdx.vercel.app/advanced/components#mdxprovider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -525,7 +525,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f2559..bfc161c542ee 100644
--- a/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/versioned_docs/version-2.4.1/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/versioned_docs/version-2.4.1/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-2.4.1/i18n/i18n-crowdin.mdx
index bd0306091f62..011b332d4ab6 100644
--- a/website/versioned_docs/version-2.4.1/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-2.4.1/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -393,7 +393,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -442,7 +442,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/versioned_docs/version-2.4.1/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-2.4.1/i18n/i18n-tutorial.mdx
index 1cdd4e6e4bc0..de7c22845af1 100644
--- a/website/versioned_docs/version-2.4.1/i18n/i18n-tutorial.mdx
+++ b/website/versioned_docs/version-2.4.1/i18n/i18n-tutorial.mdx
@@ -88,7 +88,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -115,7 +115,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `<Translate>` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`<option>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)) would [coerce it to a string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString), which returns `"[object Object]"`. While we encourage you to use `<Translate>` as JSX children, only use the element form when it actually works.
 
@@ -224,7 +224,7 @@ Most documentation websites are generally **static** and don't need advanced i18
 
 The `docusaurus write-translations` command will statically analyze all React code files used in your site, extract calls to these APIs, and aggregate them in the `code.json` file. The translation files will be stored as maps from IDs to translation message objects (including the translated label and the description of the label). In your calls to the translation APIs (`<Translate>` or `translate()`), you need to specify either the default untranslated message or the ID, in order for Docusaurus to correctly correlate each translation entry to the API call.
 
-:::caution text labels must be static
+:::warning text labels must be static
 
 The `docusaurus write-translations` command only does **static analysis** of your code. It doesn't actually run your site. Therefore, dynamic messages can't be extracted, as the message is an _expression_, not a _string_:
 
@@ -420,7 +420,7 @@ cp -r src/pages/**.md i18n/fr/docusaurus-plugin-content-pages
 cp -r src/pages/**.mdx i18n/fr/docusaurus-plugin-content-pages
 ```
 
-:::caution
+:::warning
 
 We only copy `.md` and `.mdx` files, as React pages are translated through JSON translation files already.
 
@@ -495,7 +495,7 @@ On your [static hosting provider](../deployment.mdx):
 - configure the appropriate build command, using the `--locale` option
 - configure the (sub)domain of your choice for each deployment
 
-:::caution
+:::warning
 
 This strategy is **not possible** with GitHub Pages, as it is only possible to **have a single deployment**.
 
diff --git a/website/versioned_docs/version-2.4.1/migration/migration-manual.mdx b/website/versioned_docs/version-2.4.1/migration/migration-manual.mdx
index a44c4ac8ca17..7f8984eab358 100644
--- a/website/versioned_docs/version-2.4.1/migration/migration-manual.mdx
+++ b/website/versioned_docs/version-2.4.1/migration/migration-manual.mdx
@@ -293,7 +293,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Your Algolia DocSearch v1 config (found [here](https://github.com/algolia/docsearch-configs/blob/master/configs)) should be updated for Docusaurus v2 ([example](https://github.com/algolia/docsearch-configs/tree/master/configs/docusaurus-2.json)).
 
diff --git a/website/versioned_docs/version-2.4.1/migration/migration-translated-sites.mdx b/website/versioned_docs/version-2.4.1/migration/migration-translated-sites.mdx
index 57aa277974c2..ddc48fd3b820 100644
--- a/website/versioned_docs/version-2.4.1/migration/migration-translated-sites.mdx
+++ b/website/versioned_docs/version-2.4.1/migration/migration-translated-sites.mdx
@@ -70,7 +70,7 @@ This section will help you figure out how to **keep your existing v1 translation
 
 There are **multiple possible strategies** to migrate a Docusaurus v1 site using Crowdin, with different tradeoffs.
 
-:::caution
+:::warning
 
 This documentation is a best-effort to help you migrate, please help us improve it if you find a better way!
 
@@ -150,7 +150,7 @@ Crowdin has an "upload translations" feature, but in our experience it does not
 
 If you don't mind modifying your existing Crowdin project and risking to mess things up, it may be possible to use the Crowdin branch system.
 
-:::caution
+:::warning
 
 This workflow has not been tested in practice, please report us how good it is.
 
diff --git a/website/versioned_docs/version-2.4.1/search.mdx b/website/versioned_docs/version-2.4.1/search.mdx
index 78f785bca0cb..3b260fcd7fe5 100644
--- a/website/versioned_docs/version-2.4.1/search.mdx
+++ b/website/versioned_docs/version-2.4.1/search.mdx
@@ -131,7 +131,7 @@ Refer to its [official DocSearch documentation](https://docsearch.algolia.com/do
 
 :::
 
-:::caution
+:::warning
 
 The search feature will not work reliably until Algolia crawls your site.
 
diff --git a/website/versioned_docs/version-2.4.1/seo.mdx b/website/versioned_docs/version-2.4.1/seo.mdx
index c6a2cfd78521..ea09f87d4ae8 100644
--- a/website/versioned_docs/version-2.4.1/seo.mdx
+++ b/website/versioned_docs/version-2.4.1/seo.mdx
@@ -122,7 +122,7 @@ Disallow:
 
 Read more about the robots file in [the Google documentation](https://developers.google.com/search/docs/advanced/robots/intro).
 
-:::caution
+:::warning
 
 **Important**: the `robots.txt` file does **not** prevent HTML pages from being indexed.
 
diff --git a/website/versioned_docs/version-2.4.1/static-assets.mdx b/website/versioned_docs/version-2.4.1/static-assets.mdx
index eb9d319b3c87..29efce9e6cd3 100644
--- a/website/versioned_docs/version-2.4.1/static-assets.mdx
+++ b/website/versioned_docs/version-2.4.1/static-assets.mdx
@@ -69,7 +69,7 @@ You write a link like this: [Download this document](/files/note.docx)
 Docusaurus changes that to: <a href={require('static/files/note.docx')}>Download this document</a>
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `<a>` / `<img>`, nothing will be done.
 
diff --git a/website/versioned_docs/version-2.4.1/styling-layout.mdx b/website/versioned_docs/version-2.4.1/styling-layout.mdx
index cac5c8ca8600..27c00672a61c 100644
--- a/website/versioned_docs/version-2.4.1/styling-layout.mdx
+++ b/website/versioned_docs/version-2.4.1/styling-layout.mdx
@@ -189,7 +189,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/versioned_docs/version-2.4.1/swizzling.mdx b/website/versioned_docs/version-2.4.1/swizzling.mdx
index dcddfbe07864..21ef6eb1d0d5 100644
--- a/website/versioned_docs/version-2.4.1/swizzling.mdx
+++ b/website/versioned_docs/version-2.4.1/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/advanced/client.mdx b/website/versioned_docs/version-3.0.0-alpha.0/advanced/client.mdx
index 189faab8ba56..6a01e76346da 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/advanced/client.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/advanced/client.mdx
@@ -52,7 +52,7 @@ export default function CodeBlock(props) {
 
 Check the code of `@docusaurus/theme-live-codeblock` for details.
 
-:::caution
+:::warning
 
 Unless you want to publish a re-usable "theme enhancer" (like `@docusaurus/theme-live-codeblock`), you likely don't need `@theme-init`.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/advanced/ssg.mdx b/website/versioned_docs/version-3.0.0-alpha.0/advanced/ssg.mdx
index 7fd0724ece35..07931249bbc8 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/advanced/ssg.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/advanced/ssg.mdx
@@ -122,7 +122,7 @@ If you want to render any dynamic content on your screen that relies on the brow
 
 You may need to escape from SSR since static HTML can't display anything useful without knowing the client state.
 
-:::caution
+:::warning
 
 It is important for the first client-side render to produce the exact same DOM structure as server-side rendering, otherwise, React will correlate virtual DOM with the wrong DOM elements.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/docusaurus.config.js.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/docusaurus.config.js.mdx
index 80ca18d0693b..9259b0e1856d 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/docusaurus.config.js.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/docusaurus.config.js.mdx
@@ -612,7 +612,7 @@ module.exports = {
 
 ![A sample base URL issue banner. The style is very raw since the stylesheets failed to load. The text says "Your Docusaurus site did not load properly... Current configured baseUrl = / (default value); We suggest trying baseUrl = /build/](/img/baseUrlIssueBanner.png)
 
-:::caution
+:::warning
 
 This banner needs to inline CSS / JS in case all asset loading fails due to wrong base URL.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/create-docusaurus.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/misc/create-docusaurus.mdx
index b4dc0491e4a8..039145e1dfc5 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/create-docusaurus.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/misc/create-docusaurus.mdx
@@ -24,7 +24,7 @@ The `template` argument can be one of the following:
 
 The `rootDir` will be used to resolve the absolute path to the site directory. The default is CWD.
 
-:::caution
+:::warning
 
 This command should be preferably used in an interactive shell so all features are available.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/logger.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/logger.mdx
index 04800ed25b78..18ecf3ef07b1 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/logger.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/misc/logger/logger.mdx
@@ -34,7 +34,7 @@ It exports a single object as default export: `logger`. `logger` has the followi
   - `success`: prints a success message.
 - The `report` function. It takes a `ReportingSeverity` value (`ignore`, `log`, `warn`, `throw`) and reports a message according to the severity.
 
-:::caution A word on the `error` formatter
+:::warning A word on the `error` formatter
 
 Beware that an `error` message, even when it doesn't hang the program, is likely going to cause confusion. When users inspect logs and find an `[ERROR]`, even when the build succeeds, they will assume something is going wrong. Use it sparingly.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/README.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/README.mdx
index 970af327d0df..77ce21e5f955 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/README.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/README.mdx
@@ -1,6 +1,6 @@
 # Plugin Method References
 
-:::caution
+:::warning
 
 This section is a work in progress. Anchor links or even URLs are not guaranteed to be stable.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/extend-infrastructure.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/extend-infrastructure.mdx
index 1885129b7007..339490376945 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/extend-infrastructure.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/extend-infrastructure.mdx
@@ -33,7 +33,7 @@ module.exports = function (context, options) {
 
 Register an extra command to enhance the CLI of Docusaurus. `cli` is a [commander](https://www.npmjs.com/package/commander/v/5.1.0) object.
 
-:::caution
+:::warning
 
 The commander version matters! We use commander v5, and make sure you are referring to the right version documentation for available APIs.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/lifecycle-apis.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/lifecycle-apis.mdx
index 07257073f163..130884c6d65f 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/lifecycle-apis.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugin-methods/lifecycle-apis.mdx
@@ -113,7 +113,7 @@ This function permits one to create some global plugin data that can be read fro
 
 This data becomes accessible to your client-side/theme code through the [`useGlobalData`](../../docusaurus-core.mdx#useGlobalData) and [`usePluginData`](../../docusaurus-core.mdx#usePluginData) hooks.
 
-:::caution
+:::warning
 
 Global data is... global: its size affects the loading time of all pages of your site, so try to keep it small. Prefer `createData` and page-specific data whenever possible.
 
@@ -157,7 +157,7 @@ export default function friendsPlugin(context, options) {
 
 Modifies the internal webpack config. If the return value is a JavaScript object, it will be merged into the final config using [`webpack-merge`](https://github.com/survivejs/webpack-merge). If it is a function, it will be called and receive `config` as the first argument and an `isServer` flag as the second argument.
 
-:::caution
+:::warning
 
 The API of `configureWebpack` will be modified in the future to accept an object (`configureWebpack({config, isServer, utils, content})`)
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-client-redirects.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-client-redirects.mdx
index 8e6bd08173f2..2f5c29d7761f 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-client-redirects.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-client-redirects.mdx
@@ -11,13 +11,13 @@ Docusaurus Plugin to generate **client-side redirects**.
 
 This plugin will write additional HTML pages to your static site that redirect the user to your existing Docusaurus pages with JavaScript.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
 :::
 
-:::caution
+:::warning
 
 It is better to use server-side redirects whenever possible.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-blog.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-blog.mdx
index 52212f8b56c1..54adf6d725a6 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-blog.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-content-blog.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 Provides the [Blog](blog.mdx) feature and is the default blog plugin for Docusaurus.
 
-:::caution some features production only
+:::warning some features production only
 
 The [feed feature](../../blog.mdx#feed) works by extracting the build output, and is **only active in production**.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-analytics.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-analytics.mdx
index 97b5cc0f3fd0..555e5bea7277 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-analytics.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-analytics.mdx
@@ -19,7 +19,7 @@ If you are still using this plugin with a `UA-*` tracking id, you should create
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-gtag.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-gtag.mdx
index dc1eeaf7b6fc..501b6c2f42c8 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-gtag.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-gtag.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-tag-manager.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-tag-manager.mdx
index 6e3830a46d78..43182aec075d 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-tag-manager.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-google-tag-manager.mdx
@@ -15,7 +15,7 @@ You can use [Google's Tag Assistant](https://tagassistant.google.com/) tool to c
 
 :::
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** to avoid polluting the analytics statistics.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-ideal-image.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-ideal-image.mdx
index 53564895d882..5613f4b981a2 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-ideal-image.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-ideal-image.mdx
@@ -36,7 +36,7 @@ import thumbnail from './path/to/img.png';
 <Image img={require('./path/to/img.png')} />
 ```
 
-:::caution
+:::warning
 
 This plugin registers a [Webpack loader](https://webpack.js.org/loaders/) that changes the type of imported/require images:
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-pwa.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-pwa.mdx
index 2f2c8351b874..6f12d9402213 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-pwa.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-pwa.mdx
@@ -90,7 +90,7 @@ By default, offline mode is enabled when the site is installed as an app. See th
 
 After the site has been precached, the service worker will serve cached responses for later visits. When a new build is deployed along with a new service worker, the new one will begin installing and eventually move to a waiting state. During this waiting state, a reload popup will show and ask the user to reload the page for new content. Until the user either clears the application cache or clicks the `reload` button on the popup, the service worker will continue serving the old content.
 
-:::caution
+:::warning
 
 Offline mode / precaching requires downloading all the static assets of the site ahead of time, and can consume unnecessary bandwidth. It may not be a good idea to activate it for all kind of sites.
 
@@ -124,7 +124,7 @@ Strategies used to turn the offline mode on:
 - `saveData`: activates for users with `navigator.connection.saveData === true`
 - `always`: activates for all users
 
-:::caution
+:::warning
 
 Use this carefully: some users may not like to be forced to use the offline mode.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-sitemap.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-sitemap.mdx
index 8bf823bc429f..0d6b72763c03 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-sitemap.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/plugins/plugin-sitemap.mdx
@@ -9,7 +9,7 @@ import APITable from '@site/src/components/APITable';
 
 This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.
 
-:::caution production only
+:::warning production only
 
 This plugin is always inactive in development and **only active in production** because it works on the build output.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/overview.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/themes/overview.mdx
index 4bb78e7ff0b1..98084d7418cc 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/overview.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/themes/overview.mdx
@@ -16,7 +16,7 @@ The main themes implement the user interface for the [docs](../plugins/plugin-co
 - [@docusaurus/theme-classic](./theme-classic.mdx)
 - 🚧 other themes are planned
 
-:::caution
+:::warning
 
 The goal is to have all themes share the exact same features, user-experience and configuration.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-configuration.mdx b/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-configuration.mdx
index 76801a7b8b7a..1c41523e4ab4 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-configuration.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/api/themes/theme-configuration.mdx
@@ -51,7 +51,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 With `respectPrefersColorScheme: true`, the `defaultMode` is overridden by user system preferences.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/blog.mdx b/website/versioned_docs/version-3.0.0-alpha.0/blog.mdx
index 742692f55570..5f8e553ab99c 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/blog.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/blog.mdx
@@ -374,7 +374,7 @@ website/i18n/[locale]/docusaurus-plugin-content-blog/authors.yml
 
 An author, either declared through front matter or through the authors map, needs to have a name or an avatar, or both. If all authors of a post don't have names, Docusaurus will display their avatars compactly. See [this test post](/tests/blog/2022/01/20/image-only-authors) for the effect.
 
-:::caution Feed generation
+:::warning Feed generation
 
 [RSS feeds](#feed) require the author's email to be set for the author to appear in the feed.
 
@@ -618,7 +618,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Don't forget to delete the existing homepage at `./src/pages/index.js` or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/browser-support.mdx b/website/versioned_docs/version-3.0.0-alpha.0/browser-support.mdx
index 404601d8f45e..79c01861d705 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/browser-support.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/browser-support.mdx
@@ -33,7 +33,7 @@ However, this penalizes all other users with increased site load time because th
 
 The browser list by default is provided through the `package.json` file as a root `browserslist` field.
 
-:::caution
+:::warning
 
 On old browsers, the compiled output will use unsupported (too recent) JS syntax, causing React to fail to initialize and end up with a static website with only HTML/CSS and no JS.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/cli.mdx b/website/versioned_docs/version-3.0.0-alpha.0/cli.mdx
index de6e4babb64a..0b38c01776f7 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/cli.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/cli.mdx
@@ -46,7 +46,7 @@ Builds and serves a preview of your site locally with [Webpack Dev Server](https
 | `--poll [optionalIntervalMs]` | `false` | Use polling of files rather than watching for live reload as a fallback in environments where watching doesn't work. More information [here](https://webpack.js.org/configuration/watch/#watchoptionspoll). |
 | `--no-minify` | `false` | Build website without minimizing JS/CSS bundles. |
 
-:::important
+:::info
 
 Please note that some functionality (for example, anchor links) will not work in development. The functionality will work as expected in production.
 
@@ -125,7 +125,7 @@ The swizzle CLI is interactive and will guide you through the whole [swizzle pro
 | `--typescript` | Swizzle the TypeScript variant component |
 | `--config` | Path to docusaurus config file, default to `[siteDir]/docusaurus.config.js` |
 
-:::caution
+:::warning
 
 Unsafe components have a higher risk of breaking changes due to internal refactorings.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/deployment.mdx b/website/versioned_docs/version-3.0.0-alpha.0/deployment.mdx
index 67a5c0280241..ecaa0be8f6ed 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/deployment.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/deployment.mdx
@@ -177,7 +177,7 @@ If you did not configure these build options, you may still go to "Site settings
 
 Once properly configured with the above options, your site should deploy and automatically redeploy upon merging to your deploy branch, which defaults to `main`.
 
-:::caution
+:::warning
 
 Some Docusaurus sites put the `docs` folder outside of `website` (most likely former Docusaurus v1 sites):
 
@@ -254,7 +254,7 @@ First, modify your `docusaurus.config.js` and add the following params:
 
 These fields also have their environment variable counterparts, which have a higher priority: `ORGANIZATION_NAME`, `PROJECT_NAME`, and `DEPLOYMENT_BRANCH`.
 
-:::caution
+:::warning
 
 GitHub Pages adds a trailing slash to Docusaurus URLs by default. It is recommended to set a `trailingSlash` config (`true` or `false`, not `undefined`).
 
@@ -334,7 +334,7 @@ cmd /C 'set "GIT_USER=<GITHUB_USERNAME>" && yarn deploy'
 </Tabs>
 ```
 
-:::caution
+:::warning
 
 Beginning in August 2021, GitHub requires every command-line sign-in to use the **personal access token** instead of the password. When GitHub prompts for your password, enter the PAT instead. See the [GitHub documentation](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) for more information.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/docusaurus-core.mdx b/website/versioned_docs/version-3.0.0-alpha.0/docusaurus-core.mdx
index 7e6615d8841e..40fcb7cd9fba 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/docusaurus-core.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/docusaurus-core.mdx
@@ -57,7 +57,7 @@ This component doesn't catch build-time errors and only protects against client-
 
 - `fallback`: an optional render callback returning a JSX element. It will receive an object with 2 attributes: `error`, the error that was caught, and `tryAgain`, a function (`() => void`) callback to reset the error in the component and try rendering it again. If not present, `@theme/Error` will be rendered instead. `@theme/Error` is used for the error boundaries wrapping the site, above the layout.
 
-:::caution
+:::warning
 
 The `fallback` prop is a callback, and **not a React functional component**. You can't use React hooks inside this callback.
 
@@ -411,7 +411,7 @@ The `siteConfig` object only contains **serializable values** (values that are p
 
 Returns `true` when the React app has successfully hydrated in the browser.
 
-:::caution
+:::warning
 
 Use this hook instead of `typeof windows !== 'undefined'` in React rendering logic.
 
@@ -437,7 +437,7 @@ const MyComponent = () => {
 
 React hook to prepend your site `baseUrl` to a string.
 
-:::caution
+:::warning
 
 **Don't use it for regular links!**
 
@@ -697,7 +697,7 @@ export default function Home() {
 
 A module that exposes a few boolean variables to check the current rendering environment.
 
-:::caution
+:::warning
 
 For React rendering logic, use [`useIsBrowser()`](#useIsBrowser) or [`<BrowserOnly>`](#browseronly) instead.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/creating-pages.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/creating-pages.mdx
index 30ffdb9faf68..ce32424a2544 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/creating-pages.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/creating-pages.mdx
@@ -129,7 +129,7 @@ my-website
 .
 ```
 
-:::caution
+:::warning
 
 All JavaScript/TypeScript files within the `src/pages/` directory will have corresponding website paths generated for them. If you want to create reusable components into that directory, use the `exclude` option (by default, files prefixed with `_`, test files(`.test.js`), and files in `__tests__` directory are not turned into pages).
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-introduction.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-introduction.mdx
index 250342e26b80..6e27e6be7705 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-introduction.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-introduction.mdx
@@ -95,7 +95,7 @@ slug: /
 This page will be the home page when users visit https://example.com/.
 ```
 
-:::caution
+:::warning
 
 If you added `slug: /` to a doc to make it the homepage, you should delete the existing homepage at `./src/pages/index.js`, or else there will be two files mapping to the same route!
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-multi-instance.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-multi-instance.mdx
index c1acd0195b68..d9934e3bcebd 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-multi-instance.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/docs-multi-instance.mdx
@@ -29,7 +29,7 @@ If you build a cross-platform mobile SDK, you may have 2 documentations:
 
 In this case, you can use a distinct docs plugin instance per mobile SDK documentation.
 
-:::caution
+:::warning
 
 If each documentation instance is very large, you should rather create 2 distinct Docusaurus sites.
 
@@ -55,7 +55,7 @@ Suppose you have 2 documentations:
 
 In this case, you should use the same plugin twice in your site configuration.
 
-:::caution
+:::warning
 
 `@docusaurus/preset-classic` already includes a docs plugin instance for you!
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/autogenerated.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/autogenerated.mdx
index edaa670c6d03..b812da5e33b3 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/autogenerated.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/autogenerated.mdx
@@ -408,7 +408,7 @@ To make it **easier to adopt**, Docusaurus supports **multiple number prefix pat
 
 By default, Docusaurus will **remove the number prefix** from the doc id, title, label, and URL paths.
 
-:::caution
+:::warning
 
 **Prefer using [additional metadata](#autogenerated-sidebar-metadata)**.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/items.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/items.mdx
index 1e358a12fee6..77789ebf474c 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/items.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/sidebar/items.mdx
@@ -400,7 +400,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 When a category has `collapsed: true` but `collapsible: false` (either through `sidebars.js` or through plugin configuration), the latter takes precedence and the category is still rendered as expanded.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/versioning.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/versioning.mdx
index df27a964f07f..2b5657f48d81 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/versioning.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/docs/versioning.mdx
@@ -11,7 +11,7 @@ import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 ```
 
-:::caution
+:::warning
 
 Think about it before starting to version your documentation - it can become difficult for contributors to help improve it!
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-code-blocks.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-code-blocks.mdx
index 6f87578892e0..e2f1dab444d0 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-code-blocks.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-code-blocks.mdx
@@ -80,7 +80,7 @@ Because a Prism theme is just a JS object, you can also write your own theme if
 
 By default, Docusaurus comes with a subset of [commonly used languages](https://github.com/FormidableLabs/prism-react-renderer/blob/master/packages/generate-prism-languages/index.ts#L9-L23).
 
-:::caution
+:::warning
 
 Some popular languages like Java, C#, or PHP are not enabled by default.
 
@@ -512,7 +512,7 @@ function Clock(props) {
 
 ### Imports {#imports}
 
-:::caution react-live and imports
+:::warning react-live and imports
 
 It is not possible to import components directly from the react-live code editor, you have to define available imports upfront.
 
@@ -644,13 +644,13 @@ If you want to embed HTML markup such as anchor links or bold type, you can use
   </pre>
 </BrowserWindow>
 
-:::caution MDX is whitespace insensitive
+:::warning MDX is whitespace insensitive
 
 MDX is in line with JSX behavior: line break characters, even when inside `<pre>`, are turned into spaces. You have to explicitly write the new line character for it to be printed out.
 
 :::
 
-:::caution
+:::warning
 
 Syntax highlighting only works on plain strings. Docusaurus will not attempt to parse code block content containing JSX children.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-intro.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-intro.mdx
index 2da413878351..980f8dc99e7f 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-intro.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-intro.mdx
@@ -12,7 +12,7 @@ Documentation is one of your product's interfaces with your users. A well-writte
 
 Docusaurus 2 uses modern tooling to help you compose your interactive documentation with ease. You may embed React components, or build live coding blocks where your users may play with the code on the spot. Start sharing your eureka moments with the code your audience cannot walk away from. It is perhaps the most effective way of attracting potential users.
 
-:::important
+:::info
 
 This section assumes you are using the official Docusaurus content plugins.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-math-equations.mdx
index 1b1a8ad38d7a..74aa4349e55f 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-math-equations.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-math-equations.mdx
@@ -57,7 +57,7 @@ To enable KaTeX, you need to install `remark-math` and `rehype-katex` plugins.
 npm install --save remark-math@5 rehype-katex@6
 ```
 
-:::caution
+:::warning
 
 Make sure to use `remark-math >= 5` and `rehype-katex >= 6` for Docusaurus v3 (using MDX v2).
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-plugins.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-plugins.mdx
index 1db6a6a67ee5..00c45da6b162 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-plugins.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-plugins.mdx
@@ -57,7 +57,7 @@ Next, the `rehype-katex` operates on the Hypertext AST where everything has been
 
 </details>
 
-:::caution
+:::warning
 
 Many official Remark/Rehype plugins are using ES Modules, a new JavaScript module system, which Docusaurus doesn't support yet. To work around this issue, we recommend to use dynamic `import()` inside an `async` config creation function.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.mdx
index 9c1272f9a50b..880565188678 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-react.mdx
@@ -87,7 +87,7 @@ I can write **Markdown** alongside my _JSX_!
 </BrowserWindow>
 ```
 
-:::caution MDX is JSX
+:::warning MDX is JSX
 
 Since all doc files are parsed using MDX, anything that looks like HTML is actually JSX. Therefore, if you need to inline-style a component, follow JSX flavor and provide style objects.
 
@@ -213,7 +213,7 @@ From MDX v2+ onward (Docusaurus v3+), lower-case tag names are always rendered a
 
 :::
 
-:::caution
+:::warning
 
 This feature is powered by [an `MDXProvider`](https://mdxjs.com/docs/using-mdx/#mdx-provider). If you are importing Markdown in a React page, you have to supply this provider yourself through the `MDXContent` theme component.
 
@@ -334,7 +334,7 @@ import PartialExample from './_markdown-partial-example.mdx';
 
 This way, you can reuse content among multiple pages and avoid duplicating materials.
 
-:::caution
+:::warning
 
 Currently, the table of contents does not contain the imported Markdown headings. This is a technical limitation that we are trying to solve ([issue](https://github.com/facebook/docusaurus/issues/3915)).
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-toc.mdx b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-toc.mdx
index b1b6507f2559..bfc161c542ee 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-toc.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/guides/markdown-features/markdown-features-toc.mdx
@@ -53,7 +53,7 @@ Use the **[`write-heading-ids`](../../cli.mdx#docusaurus-write-heading-ids-sited
 
 :::
 
-:::caution Avoid colliding IDs
+:::warning Avoid colliding IDs
 
 Generated heading IDs will be guaranteed to be unique on each page, but if you use custom IDs, make sure each one appears exactly once on each page, or there will be two DOM elements with the same ID, which is invalid HTML semantics, and will lead to one heading being unlinkable.
 
@@ -174,7 +174,7 @@ The ability to ergonomically insert extra headings or ignore certain headings is
 
 ---
 
-:::caution
+:::warning
 
 Below is just some dummy content to have more table of contents items available on the current page.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-crowdin.mdx b/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-crowdin.mdx
index b57dbb71e093..b10c9246d82c 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-crowdin.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-crowdin.mdx
@@ -12,7 +12,7 @@ You can integrate Docusaurus with the **tools and SaaS of your choice**, as long
 
 We document the usage of [Crowdin](https://crowdin.com/), as **one** possible **integration example**.
 
-:::caution
+:::warning
 
 This is **not an endorsement of Crowdin** as the unique choice to translate a Docusaurus site, but it is successfully used by Facebook to translate documentation projects such as [Jest](https://jestjs.io/), [Docusaurus](https://docusaurus.io/), and [ReasonML](https://reasonml.github.io/).
 
@@ -166,7 +166,7 @@ You can keep the default value `CROWDIN_PERSONAL_TOKEN`, and set this environmen
 
 :::
 
-:::caution
+:::warning
 
 A Personal Access Tokens grant **read-write access to all your Crowdin projects**.
 
@@ -318,7 +318,7 @@ Keep your deploy-previews fast: don't download translations, and use `npm run bu
 
 :::
 
-:::caution
+:::warning
 
 Crowdin does not support well multiple concurrent uploads/downloads: it is preferable to only include translations to your production deployment, and keep deploy previews untranslated.
 
@@ -328,7 +328,7 @@ Crowdin does not support well multiple concurrent uploads/downloads: it is prefe
 
 ### MDX {#mdx}
 
-:::caution
+:::warning
 
 Pay special attention to the JSX fragments in MDX documents!
 
@@ -394,7 +394,7 @@ Crowdin provides a `Duplicate Strings` setting.
 
 We recommend using `Hide`, but the ideal setting depends on how much your versions are different.
 
-:::caution
+:::warning
 
 Not using `Hide` leads to a much larger amount of `source strings` in quotas, and will affect the pricing.
 
@@ -443,7 +443,7 @@ In practice, **it didn't work very reliably** for a few reasons:
 
 Crowdin has an [In-Context localization](https://support.crowdin.com/in-context-localization/) feature.
 
-:::caution
+:::warning
 
 Unfortunately, it does not work yet for technical reasons, but we have good hope it can be solved.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-tutorial.mdx b/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-tutorial.mdx
index 7e9de4cbb799..45057041fc7e 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-tutorial.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/i18n/i18n-tutorial.mdx
@@ -96,7 +96,7 @@ Please help us complete those **[default translations](https://github.com/facebo
 
 :::
 
-:::caution
+:::warning
 
 Each locale is a **distinct standalone single-page application**: it is not possible to start the Docusaurus sites in all locales at the same time.
 
@@ -123,7 +123,7 @@ Locate all text labels in your React code that will be visible to your users, an
 
 Use the one that better fits the context semantically. For example, the `<Translate>` can be used as React children, while for props that expect a string, the callback can be used.
 
-:::caution
+:::warning
 
 A JSX element is an _object_, not a string. Using it in contexts expecting strings (such as the children of [`<option>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/option)) would [coerce it to a string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString), which returns `"[object Object]"`. While we encourage you to use `<Translate>` as JSX children, only use the element form when it actually works.
 
@@ -232,7 +232,7 @@ Most documentation websites are generally **static** and don't need advanced i18
 
 The `docusaurus write-translations` command will statically analyze all React code files used in your site, extract calls to these APIs, and aggregate them in the `code.json` file. The translation files will be stored as maps from IDs to translation message objects (including the translated label and the description of the label). In your calls to the translation APIs (`<Translate>` or `translate()`), you need to specify either the default untranslated message or the ID, in order for Docusaurus to correctly correlate each translation entry to the API call.
 
-:::caution text labels must be static
+:::warning text labels must be static
 
 The `docusaurus write-translations` command only does **static analysis** of your code. It doesn't actually run your site. Therefore, dynamic messages can't be extracted, as the message is an _expression_, not a _string_:
 
@@ -428,7 +428,7 @@ cp -r src/pages/**.md i18n/fr/docusaurus-plugin-content-pages
 cp -r src/pages/**.mdx i18n/fr/docusaurus-plugin-content-pages
 ```
 
-:::caution
+:::warning
 
 We only copy `.md` and `.mdx` files, as React pages are translated through JSON translation files already.
 
@@ -503,7 +503,7 @@ On your [static hosting provider](../deployment.mdx):
 - configure the appropriate build command, using the `--locale` option
 - configure the (sub)domain of your choice for each deployment
 
-:::caution
+:::warning
 
 This strategy is **not possible** with GitHub Pages, as it is only possible to **have a single deployment**.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-manual.mdx b/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-manual.mdx
index a44c4ac8ca17..7f8984eab358 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-manual.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-manual.mdx
@@ -293,7 +293,7 @@ module.exports = {
 };
 ```
 
-:::caution
+:::warning
 
 Your Algolia DocSearch v1 config (found [here](https://github.com/algolia/docsearch-configs/blob/master/configs)) should be updated for Docusaurus v2 ([example](https://github.com/algolia/docsearch-configs/tree/master/configs/docusaurus-2.json)).
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-translated-sites.mdx b/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-translated-sites.mdx
index 57aa277974c2..ddc48fd3b820 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-translated-sites.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/migration/migration-translated-sites.mdx
@@ -70,7 +70,7 @@ This section will help you figure out how to **keep your existing v1 translation
 
 There are **multiple possible strategies** to migrate a Docusaurus v1 site using Crowdin, with different tradeoffs.
 
-:::caution
+:::warning
 
 This documentation is a best-effort to help you migrate, please help us improve it if you find a better way!
 
@@ -150,7 +150,7 @@ Crowdin has an "upload translations" feature, but in our experience it does not
 
 If you don't mind modifying your existing Crowdin project and risking to mess things up, it may be possible to use the Crowdin branch system.
 
-:::caution
+:::warning
 
 This workflow has not been tested in practice, please report us how good it is.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/search.mdx b/website/versioned_docs/version-3.0.0-alpha.0/search.mdx
index 78f785bca0cb..3b260fcd7fe5 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/search.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/search.mdx
@@ -131,7 +131,7 @@ Refer to its [official DocSearch documentation](https://docsearch.algolia.com/do
 
 :::
 
-:::caution
+:::warning
 
 The search feature will not work reliably until Algolia crawls your site.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/seo.mdx b/website/versioned_docs/version-3.0.0-alpha.0/seo.mdx
index 048a23a66808..b411de7ea560 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/seo.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/seo.mdx
@@ -181,7 +181,7 @@ Disallow:
 
 Read more about the robots file in [the Google documentation](https://developers.google.com/search/docs/advanced/robots/intro).
 
-:::caution
+:::warning
 
 **Important**: the `robots.txt` file does **not** prevent HTML pages from being indexed.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/static-assets.mdx b/website/versioned_docs/version-3.0.0-alpha.0/static-assets.mdx
index eb9d319b3c87..29efce9e6cd3 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/static-assets.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/static-assets.mdx
@@ -69,7 +69,7 @@ You write a link like this: [Download this document](/files/note.docx)
 Docusaurus changes that to: <a href={require('static/files/note.docx')}>Download this document</a>
 ```
 
-:::caution use Markdown syntax
+:::warning use Markdown syntax
 
 Docusaurus will only parse links that are in Markdown syntax. If your asset references are using the JSX tag `<a>` / `<img>`, nothing will be done.
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/styling-layout.mdx b/website/versioned_docs/version-3.0.0-alpha.0/styling-layout.mdx
index af653e814174..68e872ff6cfb 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/styling-layout.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/styling-layout.mdx
@@ -215,7 +215,7 @@ The class names will be processed by webpack into a globally unique class name d
 
 ## CSS-in-JS {#css-in-js}
 
-:::caution
+:::warning
 
 CSS-in-JS support is a work in progress, so libs like MUI may have display quirks. [Welcoming PRs](https://github.com/facebook/docusaurus/issues/1640).
 
diff --git a/website/versioned_docs/version-3.0.0-alpha.0/swizzling.mdx b/website/versioned_docs/version-3.0.0-alpha.0/swizzling.mdx
index 45f216420ceb..6f4759c50da7 100644
--- a/website/versioned_docs/version-3.0.0-alpha.0/swizzling.mdx
+++ b/website/versioned_docs/version-3.0.0-alpha.0/swizzling.mdx
@@ -143,7 +143,7 @@ export default function Footer(props) {
 }
 ```
 
-:::caution
+:::warning
 
 Ejecting an [**unsafe**](#what-is-safe-to-swizzle) component can sometimes lead to copying a large amount of internal code, which you now have to maintain yourself. It can make Docusaurus upgrades more difficult, as you will need to migrate your customizations if the props received or internal theme APIs used have changed.