diff --git a/docs/building-mac.md b/docs/building-mac.md
index 2eafc93b30..b733ddd8cb 100644
--- a/docs/building-mac.md
+++ b/docs/building-mac.md
@@ -1,5 +1,11 @@
 ## Build instructions for macOS
 
+### Note
+
+The build has only been tested with Xcode 26.1. Although it may work on lower Xcode versions, this is not guaranteed.
+
+Xcode 26 has deprecated AGL, so you need to remove "AGL" from CMake options [here](https://github.com/desktop-app/cmake_helpers/blob/c7e0493dea2b870fb1b8e26604201fdb9e8c1ee5/options_mac.cmake#L64).
+
 ### Prepare folder
 
 Choose a folder for the future build, for example **/Users/user/TBuild**. It will be named ***BuildPath*** in the rest of this document. All commands will be launched from Terminal.