3 files changed, 15 insertions, 0 deletions
diff --git a/docs/gl_objects/groups.rst b/docs/gl_objects/groups.rst
index 9b5edb0..5536de2 100644
--- a/docs/gl_objects/groups.rst
+++ b/docs/gl_objects/groups.rst
@@ -126,6 +126,11 @@ Delete a custom attribute for a group::
     # or
     group.customattributes.delete(attr_key)
 
+Search groups by custom attribute::
+
+    group.customattributes.set('role': 'admin')
+    gl.groups.list(custom_attributes={'role': 'admin'})
+
 Group members
 =============
 
diff --git a/docs/gl_objects/projects.rst b/docs/gl_objects/projects.rst
index b7c5d78..0395950 100644
--- a/docs/gl_objects/projects.rst
+++ b/docs/gl_objects/projects.rst
@@ -207,6 +207,11 @@ Delete a custom attribute for a project::
     # or
     project.customattributes.delete(attr_key)
 
+Search projects by custom attribute::
+
+    project.customattributes.set('type': 'internal')
+    gl.projects.list(custom_attributes={'type': 'internal'})
+
 Project files
 =============
 
diff --git a/docs/gl_objects/users.rst b/docs/gl_objects/users.rst
index e57daf6..63609db 100644
--- a/docs/gl_objects/users.rst
+++ b/docs/gl_objects/users.rst
@@ -107,6 +107,11 @@ Delete a custom attribute for a user::
     # or
     user.customattributes.delete(attr_key)
 
+Search users by custom attribute::
+
+    user.customattributes.set('role': 'QA')
+    gl.users.list(custom_attributes={'role': 'QA'})
+
 User impersonation tokens
 =========================