diff --git a/apps/login/readme.md b/apps/login/readme.md
index f11e85fb864..402926ebcde 100644
--- a/apps/login/readme.md
+++ b/apps/login/readme.md
@@ -183,8 +183,22 @@ At the moment, U2F methods are hidden if a method is already added on the users
 
 ### /register
 
+### /idp
+
+This page doubles as /loginname but limits it to choose from IDPs
+
+<img src="./screenshots/idp.png" alt="/idp" width="400px" />
+
+Requests to the APIs made:
+
+- `getBrandingSettings(org?)`
+- `getActiveIdentityProviders(org?)`
+- `startIdentityProviderFlow()`
+
 ### /idp/[method]/success /idp/[method]/failure
 
+Both /success and /failure pages are designed to intercept the responses from the IDPs and decide on how to continue with the process.
+
 ### /verify
 
 ### /accounts
diff --git a/apps/login/screenshots/idp.png b/apps/login/screenshots/idp.png
new file mode 100644
index 00000000000..9bf58c69b05
Binary files /dev/null and b/apps/login/screenshots/idp.png differ