diff --git a/docs/data-sources/user.md b/docs/data-sources/user.md
index 8703b07dc..0a48bc593 100644
--- a/docs/data-sources/user.md
+++ b/docs/data-sources/user.md
@@ -33,7 +33,7 @@ data "gitlab_user" "example-two" {
 
 ### Optional
 
-- **email** (String) The email address of the user.
+- **email** (String) The public email address of the user. **Note**: before GitLab 14.8 the lookup was based on the users primary email address.
 - **id** (String) The ID of this resource.
 - **user_id** (Number) The ID of the user.
 - **username** (String) The username of the user.
diff --git a/gitlab/data_source_gitlab_user.go b/gitlab/data_source_gitlab_user.go
index b8776f9bc..efca98441 100644
--- a/gitlab/data_source_gitlab_user.go
+++ b/gitlab/data_source_gitlab_user.go
@@ -39,7 +39,7 @@ func dataSourceGitlabUser() *schema.Resource {
 				},
 			},
 			"email": {
-				Description: "The email address of the user.",
+				Description: "The public email address of the user. **Note**: before GitLab 14.8 the lookup was based on the users primary email address.",
 				Type:        schema.TypeString,
 				Computed:    true,
 				Optional:    true,
diff --git a/gitlab/data_source_gitlab_users.go b/gitlab/data_source_gitlab_users.go
index e7e27fa9f..19ce0dc42 100644
--- a/gitlab/data_source_gitlab_users.go
+++ b/gitlab/data_source_gitlab_users.go
@@ -88,7 +88,7 @@ func dataSourceGitlabUsers() *schema.Resource {
 							Computed:    true,
 						},
 						"email": {
-							Description: "The e-mail address of the user.",
+							Description: "The public email address of the user. **Note**: before GitLab 14.8 the lookup was based on the users primary email address.",
 							Type:        schema.TypeString,
 							Computed:    true,
 						},