diff --git a/website/docs/migration/v3.mdx b/website/docs/migration/v3.mdx
index 72646ecfe72d..9c25b1b19878 100644
--- a/website/docs/migration/v3.mdx
+++ b/website/docs/migration/v3.mdx
@@ -704,6 +704,8 @@ If you previously used the undocumented `:::warning` admonition, make sure to ve
 
 Docusaurus v3 also [deprecated the `:::caution`](https://github.com/facebook/docusaurus/pull/9308) admonition. Please refactor `:::caution` (yellow) to either `:::warning` (yellow) or `:::danger` (red).
 
+If you want to keep the title “caution”, you might want to refactor it to `:::warning[caution]` (yellow).
+
 :::
 
 ### Versioned Sidebars