diff --git a/docs/3.api/1.components/4.nuxt-link.md b/docs/3.api/1.components/4.nuxt-link.md
index eda9da975..83bbff095 100644
--- a/docs/3.api/1.components/4.nuxt-link.md
+++ b/docs/3.api/1.components/4.nuxt-link.md
@@ -116,6 +116,34 @@ Defaults can be overwritten, see [overwriting defaults](#overwriting-defaults) i
 
 ## Overwriting Defaults
 
+### In Nuxt Config
+
+You can overwrite some `<NuxtLink>` defaults in your [`nuxt.config`](https://nuxt.com/docs/api/nuxt-config#defaults)
+
+::callout{color="amber" icon="i-ph-warning-duotone"}
+These options will likely be moved elsewhere in the future, such as into `app.config` or into the `app/` directory.
+::
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+  experimental: {
+    defaults: {
+      nuxtLink: {
+        // default values
+        componentName: 'NuxtLink',
+        externalRelAttribute: 'noopener noreferrer',
+        activeClass: 'router-link-active',
+        exactActiveClass: 'router-link-exact-active',
+        prefetchedClass: undefined, // can be any valid string class name
+        trailingSlash: undefined // can be 'append' or 'remove'
+      }
+    }
+  }
+})
+```
+
+### Custom Link Component
+
 You can overwrite `<NuxtLink>` defaults by creating your own link component using `defineNuxtLink`.
 
 ```js [components/MyNuxtLink.ts]