diff --git a/docs/content/2.guide/3.directory-structure/11.plugins.md b/docs/content/2.guide/3.directory-structure/11.plugins.md
index 9ad1a449c..21fa98cca 100644
--- a/docs/content/2.guide/3.directory-structure/11.plugins.md
+++ b/docs/content/2.guide/3.directory-structure/11.plugins.md
@@ -122,4 +122,24 @@ export default defineNuxtPlugin((nuxtApp) => {
 })
 ```
 
+## Vue directives
+
+Similarly, you can register a custom Vue directive in a plugin. For example, in `plugins/directive.ts`:
+
+```ts
+export default defineNuxtPlugin((nuxtApp) => {
+  nuxtApp.vueApp.directive('focus', {
+    mounted (el) {
+      el.focus()
+    },
+    getSSRProps (binding, vnode) {
+      // you can provide SSR-specific props here
+      return {}
+    }
+  })
+})
+```
+
+:ReadMore{link="https://vuejs.org/guide/reusability/custom-directives.html"}
+
 :LinkExample{link="/examples/app/plugins"}