diff --git a/components/banner.mdx b/components/banner.mdx
index cc8228eb7..46e5086dc 100644
--- a/components/banner.mdx
+++ b/components/banner.mdx
@@ -31,6 +31,10 @@ To add a banner, use the `banner` property in your `docs.json`:
   ```
 </CodeGroup>
 
+<Note>
+  Banners can also be configured on a per-language basis by setting the banner property in `navigation.languages`.
+</Note>
+
 ## Properties
 
 <ResponseField name="content" type="string" required>