diff --git a/releasenotes/notes/make_object_metadata_easier.yaml-e9751723e002e06f.yaml b/releasenotes/notes/make_object_metadata_easier.yaml-e9751723e002e06f.yaml
new file mode 100644
index 000000000..eaa718307
--- /dev/null
+++ b/releasenotes/notes/make_object_metadata_easier.yaml-e9751723e002e06f.yaml
@@ -0,0 +1,5 @@
+---
+features:
+  - create_object() now has a "metadata" parameter that can be used to create
+    an object with metadata of each key and value pair in that dictionary
+  - Add an update_object() function that updates the metadata of a swift object
diff --git a/shade/openstackcloud.py b/shade/openstackcloud.py
index 2cbd86f45..a078d8424 100644
--- a/shade/openstackcloud.py
+++ b/shade/openstackcloud.py
@@ -4689,14 +4689,14 @@ class OpenStackCloud(object):
                         'Failed at action ({action}) [{error}]:'.format(**r))
 
     def update_object(self, container, name, metadata=None, **headers):
-        """Update the metadtata of an object
+        """Update the metadata of an object
 
         :param container: The name of the container the object is in
         :param name: Name for the object within the container.
-        :param headers: These will be passed through to the object update
-            API as HTTP Headers.
         :param metadata: This dict will get changed into headers that set
             metadata of the object
+        :param headers: These will be passed through to the object update
+            API as HTTP Headers.
 
         :raises: ``OpenStackCloudException`` on operation error.
         """