diff --git a/docs/module/lag.md b/docs/module/lag.md
index 8981da17d..c6e7b984c 100644
--- a/docs/module/lag.md
+++ b/docs/module/lag.md
@@ -66,6 +66,10 @@ links:
      ifindex: 50
 ```
 
+### Caveat: Multi-provider Labs
+
+There is a known issue with multi-provider labs, where 'lag' type links get converted into 'lan'; this breaks the lag module
+
 (mlag)=
 ## Multi-chassis Link Aggregation (MLAG)