diff --git a/website/docs/using-themes.md b/website/docs/using-themes.md
index 9c0986e6f5a3..544f93293a66 100644
--- a/website/docs/using-themes.md
+++ b/website/docs/using-themes.md
@@ -93,7 +93,13 @@ npm run swizzle @docusaurus/theme-classic Footer
 
 This will copy the current `<Footer />` component used by the theme to a `src/theme/Footer` directory under the root of your site, which is where Docusaurus will look for swizzled components. Docusaurus will then use swizzled component in place of the original one from the theme.
 
-**Note**: You need to restart your dev server for Docusaurus to pick up the new component.
+Although we highly discourage swizzling of all components, if you wish to do that, run:
+
+```bash npm2yarn
+npm run swizzle @docusaurus/theme-classic
+```
+
+**Note**: You need to restart your webpack dev server in order for Docusaurus to know about the new component.
 
 ## Official themes by Docusaurus