diff --git a/README.md b/README.md
index 68faa185e..5fb78bcef 100644
--- a/README.md
+++ b/README.md
@@ -247,6 +247,16 @@ Scope used for authentication. By default is `openid`. It will return not only t
 }
 ```
 
+#### Connection Scope
+
+Allows you to set provider scopes for oauth2/social connections. By default is empty.
+
+```swift
+.withOptions {
+  $0.connectionScope = ["facebook": "user_friends email"]
+}
+```
+
 #### Database
 
 * **allow**: Which database screens will be accessible, the default is enable all screens e.g. `.Login, .Signup, .ResetPassword`