diff --git a/Amazon-S3-API.md b/Amazon-S3-API.md
index d4df841..51991d6 100644
--- a/Amazon-S3-API.md
+++ b/Amazon-S3-API.md
@@ -71,6 +71,9 @@ Not included:
 | Multi byte ranges reads| Yes | No |
 | DeleteObject deletes a folder| Yes | No |
 
+By default, `weed s3` will automatically remove empty folders, to be consistent with AWS S3. 
+You can use `weed s3 -allowEmptyFolder` to toggle this behavior.
+
 # Authentication
 By default, the access key and secret key to access `weed s3` is not authenticated. To enable credential based access, create a config.json file similar to the example below, and specify it via `weed s3 -config=config.json`.