diff --git a/docs/resources/object_storage_key.md b/docs/resources/object_storage_key.md
index 32a78cba2..95ab82ad1 100644
--- a/docs/resources/object_storage_key.md
+++ b/docs/resources/object_storage_key.md
@@ -34,6 +34,26 @@ resource "linode_object_storage_key" "foobar" {
 }
 ```
 
+The following example shows how to grant a key the explicit access to multiple buckets.
+
+```hcl
+resource "linode_object_storage_key" "foo" {
+  label = "image-access"
+
+  bucket_access {
+    bucket_name = "foobar1"
+    cluster = "us-east-1"
+    permissions = "read_write"
+  }
+
+  bucket_access {
+    bucket_name = "foobar2"
+    cluster = "us-east-1"
+    permissions = "read_write"
+  }
+}
+```
+
 ## Argument Reference
 
 The following arguments are supported: