diff --git a/website/docs/r/objectstorage_container_v1.html.markdown b/website/docs/r/objectstorage_container_v1.html.markdown
index ee0ea4caf..1c3b88dd1 100644
--- a/website/docs/r/objectstorage_container_v1.html.markdown
+++ b/website/docs/r/objectstorage_container_v1.html.markdown
@@ -117,8 +117,12 @@ The following arguments are supported:
 * `container_write` - (Optional) Sets an ACL that grants write access.
     Changing this updates the access control list write access.
 
-* `versioning` - (Optional) A boolean that enables or disable object versioning.
-  Defaults to `false`
+* `versioning` - (Optional) A boolean that can enable or disable object
+  versioning. The default value is `false`. To use this feature, your Swift
+  version must be 2.24 or higher (as described in the [OpenStack Swift Ussuri release notes](https://docs.openstack.org/releasenotes/swift/ussuri.html#relnotes-2-24-0-stable-ussuri)),
+  and a cloud administrator must have set the `allow_object_versioning = true`
+  configuration option in Swift. If you cannot set this versioning type, you may
+  want to consider using `versioning_legacy` instead.
 
 * `versioning_legacy` - (Deprecated) Enable legacy object versioning. The structure is described below.