diff --git a/lib/storage/bucket.js b/lib/storage/bucket.js
index f84806c222b..fdefbf6fc59 100644
--- a/lib/storage/bucket.js
+++ b/lib/storage/bucket.js
@@ -989,7 +989,8 @@ Bucket.prototype.makePublic = function(options, callback) {
  *     bucket using the name of the local file.
  * @param {boolean} options.gzip - Automatically gzip the file. This will set
  *     `options.metadata.contentEncoding` to `gzip`.
- * @param {object=} options.metadata - Metadata to set for your file.
+ * @param {object=} options.metadata - See an
+ *     [Objects: insert request body](https://cloud.google.com/storage/docs/json_api/v1/objects/insert#request_properties_JSON).
  * @param {boolean=} options.resumable - Force a resumable upload. (default:
  *     true for files larger than 5 MB).
  * @param {function} callback - The callback function.
diff --git a/lib/storage/file.js b/lib/storage/file.js
index 7814ea874e1..e01ab58662a 100644
--- a/lib/storage/file.js
+++ b/lib/storage/file.js
@@ -685,7 +685,8 @@ File.prototype.createResumableUpload = function(metadata, callback) {
  * @param {object=} options - Configuration object.
  * @param {boolean} options.gzip - Automatically gzip the file. This will set
  *     `options.metadata.contentEncoding` to `gzip`.
- * @param {object} options.metadata - Set the metadata for this file.
+ * @param {object=} options.metadata - See an
+ *     [Objects: insert request body](https://cloud.google.com/storage/docs/json_api/v1/objects/insert#request_properties_JSON).
  * @param {boolean} options.resumable - Force a resumable upload. NOTE: When
  *     working with streams, the file format and size is unknown until it's
  *     completely consumed. Because of this, it's best for you to be explicit