diff --git a/docs/content/yandex.md b/docs/content/yandex.md
index cdc5f4ae6..d56c172b6 100644
--- a/docs/content/yandex.md
+++ b/docs/content/yandex.md
@@ -127,6 +127,19 @@ does not take any path arguments.
 To view your current quota you can use the `rclone about remote:`
 command which will display your usage limit (quota) and the current usage.
 
+### Limitations ###
+
+When uploading very large files (bigger than about 5GB) you will need
+to increase the `--timeout` parameter.  This is because Yandex pauses
+(perhaps to calculate the MD5SUM for the entire file) before returning
+confirmation that the file has been uploaded.  The default handling of
+timeouts in rclone is to assume a 5 minute pause is an error and close
+the connection - you'll see `net/http: timeout awaiting response
+headers` errors in the logs if this is happening.  Setting the timeout
+to twice the max size of file in GB should be enough, so if you want
+to upload a 30GB file set a timeout of `2 * 30 = 60m`, that is
+`--timeout 60m`.
+
 <!--- autogenerated options start - DO NOT EDIT, instead edit fs.RegInfo in backend/yandex/yandex.go then run make backenddocs -->
 ### Standard Options