diff --git a/docs/understanding-serverless/serverless-yml.md b/docs/understanding-serverless/serverless-yml.md
index e1076541d..54b91c448 100644
--- a/docs/understanding-serverless/serverless-yml.md
+++ b/docs/understanding-serverless/serverless-yml.md
@@ -11,6 +11,13 @@ service: first_service
 provider:
   name: aws
   runtime: nodejs4.3
+    vpc: # optional, applies to all functions described herein but is overridden by any function level settings
+      securityGroupIds:
+        - securityGroupId1
+        - securityGroupId2
+      subnetIds: 
+        - subnetId1
+        - subnetId2
 
 plugins:
   - additional_plugin
@@ -46,6 +53,13 @@ functions:
           path: users/create
           method: get
       - sns: topic-name
+    vpc: # optional, applies only to this function and overrides any provider level settings
+      securityGroupIds:
+        - securityGroupId1
+        - securityGroupId2
+      subnetIds: 
+        - subnetId1
+        - subnetId2
 
 resources:
   Resources: