diff --git a/README.md b/README.md
index c32c2681..6b885d70 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,10 @@ Set ROCKSET_APIKEY with the API key in the environment variables. To run test:
 mvn test
 ```
 
+## Scala Considerations
+
+If using [Scala](https://www.scala-lang.org/)https://www.scala-lang.org/, we recommend converting scala map and object types to java maps and collections (e.g. `java.util.LinkedHashMap`) rather than using the native Scala types with this java client.
+
 ## Support
 
 Feel free to log issues against this client through GitHub.