diff --git a/docs/docs/mapping/customizing_openapi_output.md b/docs/docs/mapping/customizing_openapi_output.md
index 730fe44ffbb..4227f1eead6 100644
--- a/docs/docs/mapping/customizing_openapi_output.md
+++ b/docs/docs/mapping/customizing_openapi_output.md
@@ -39,6 +39,12 @@ message ABitOfEverything {
             description: "Find out more about ABitOfEverything";
         }
         example: "{\"uuid\": \"0cf361e1-4b44-483d-a159-54dabdf7e814\"}"
+        extensions: {
+            key: "x-irreversible";
+            value {
+                bool_value: true;
+            }
+        }
     };
 
     string uuid = 1 [(grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {description: "The UUID field."}];
@@ -78,6 +84,29 @@ service ABitOfEverythingService {
 }
 ```
 
+[Swagger Extensions](https://swagger.io/docs/specification/2-0/swagger-extensions/) can be added as key-value pairs to the options. Keys must begin with `x-` and values can be of any type listed [here](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#value). For example:
+```
+extensions: {
+  key: "x-amazon-apigateway-authorizer";
+  value {
+    struct_value {
+      fields {
+        key: "type";
+        value {
+          string_value: "token";
+        }
+      }
+      fields {
+        key: "authorizerResultTtlInSeconds";
+        value {
+          number_value: 60;
+        }
+      }
+    }
+  }
+}
+```
+
 Please see this [a_bit_of_everything.proto](https://github.com/grpc-ecosystem/grpc-gateway/blob/master/examples/internal/proto/examplepb/a_bit_of_everything.proto) for examples of the options being used.
 
 ## Using google.api.field_behavior