diff --git a/docs/src/development/macos.md b/docs/src/development/macos.md
index d90cc89abc3e5dc70b2184c85690ea472ec647dc..c7e92623d4e226cb575da524fd8241fba3730fd6 100644
--- a/docs/src/development/macos.md
+++ b/docs/src/development/macos.md
@@ -69,6 +69,8 @@ xcrun: error: unable to find utility "metal", not a developer tool or in PATH
 
 Try `sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer`
 
+If you're on macOS 26, try `xcodebuild -downloadComponent MetalToolchain`
+
 ### Cargo errors claiming that a dependency is using unstable features
 
 Try `cargo clean` and `cargo build`.