diff --git a/README.md b/README.md
index e387ec0d049..61d353ff55a 100644
--- a/README.md
+++ b/README.md
@@ -110,3 +110,13 @@ fn main() {
 ```
 
 And run the application with `cargo apk run --example request_redraw_threaded`
+
+#### MacOS
+
+To ensure compatibility with older MacOS systems, winit links to
+`CGDisplayCreateUUIDFromDisplayID` through the `CoreGraphics` framework. However
+, under certain setups this function is only available to be linked through
+the newer `ColorSync` framework. So, winit provides the `WINIT_LINK_COLORSYNC`
+environment variable which can be set to `1` or `true` to enable linking via
+`ColorSync`.
+