1 files changed, 27 insertions, 0 deletions
diff --git a/doc/user/membership/invite_users_using_their_email_address.md b/doc/user/membership/invite_users_using_their_email_address.md
index e69de29bb2d..565adcf1e09 100644
--- a/doc/user/membership/invite_users_using_their_email_address.md
+++ b/doc/user/membership/invite_users_using_their_email_address.md
@@ -0,0 +1,27 @@
+## Invite people using their email address
+
+If a user you want to give access to doesn't have an account on your GitLab
+instance, you can invite them just by typing their e-mail address in the
+user search field.
+
+![Invite user by mail](img/add_user_email_search.png)
+
+---
+
+As you can imagine, you can mix inviting multiple people and adding existing
+GitLab users to the project.
+
+![Invite user by mail ready to submit](img/add_user_email_ready.png)
+
+---
+
+Once done, hit **Add users to project** and watch that there is a new member
+with the e-mail address we used above. From there on, you can resend the
+invitation, change their access level or even delete them.
+
+![Invite user members list](img/add_user_email_accept.png)
+
+---
+
+Once the user accepts the invitation, they will be prompted to create a new
+GitLab account using the same e-mail address the invitation was sent to.