diff --git a/docs/content/s3.md b/docs/content/s3.md
index a6f31e715..e407b729d 100644
--- a/docs/content/s3.md
+++ b/docs/content/s3.md
@@ -299,6 +299,17 @@ Notes on above:
 For reference, [here's an Ansible script](https://gist.github.com/ebridges/ebfc9042dd7c756cd101cfa807b7ae2b) 
 that will generate one or more buckets that will work with `rclone sync`.
 
+### Glacier ###
+
+You can transition objects to glacier storage using a [lifecycle policy](http://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-lifecycle.html).
+The bucket can still be synced or copied into normally, but if rclone
+tries to access the data you will see an error like below.
+
+    2017/09/11 19:07:43 Failed to sync: failed to open source object: Object in GLACIER, restore first: path/to/file
+
+In this case you need to [restore](http://docs.aws.amazon.com/AmazonS3/latest/user-guide/restore-archived-objects.html)
+the object(s) in question before using rclone.
+
 ### Specific options ###
 
 Here are the command line options specific to this cloud storage