diff --git a/docs/cow-protocol/reference/contracts/core/README.mdx b/docs/cow-protocol/reference/contracts/core/README.mdx
index c3eadbfd9..2096efb79 100644
--- a/docs/cow-protocol/reference/contracts/core/README.mdx
+++ b/docs/cow-protocol/reference/contracts/core/README.mdx
@@ -62,6 +62,10 @@ The security considerations of upgradeability are discussed in the [GPv2Allowlis
 
 ## Security / Known Issues
 
+### Disabled settlement path
+
+`GPv2Settlement.swap()` belongs to an older Balancer settlement flow that is no longer supported on Ethereum. Use the standard `settle()` flow instead.
+
 ### Orders with zero amounts
 
 If a user creates an order with `sellAmount = 0` or `buyAmount = 0`, then this order could be executed an arbitrary amount of times instead of just a single time.