diff --git a/website/docs/r/pi_host_group.html.markdown b/website/docs/r/pi_host_group.html.markdown
index b71e4d4b6f9..7999d6bb96b 100644
--- a/website/docs/r/pi_host_group.html.markdown
+++ b/website/docs/r/pi_host_group.html.markdown
@@ -62,7 +62,7 @@ You can specify the following arguments for this resource.
   Nested schema for `pi_hosts`:
       - `display_name` - (Required, String) Name of the host chosen by the user.
       - `sys_type` - (Required, String) System type.
-      - `user_tags` - (Optional, List) The user tags attached to this resource.
+      - `user_tags` - (Optional, List) The user tags attached to this resource. Please avoid reading user tags from this attribute as environment tags will not be included. Please use appropriate data sources such as `ibm_pi_host` and `ibm_pi_hosts`.
 
 - `pi_name` - (Required, String) Name of the host group to create.
 - `pi_remove` - (Optional, String) A workspace ID to stop sharing the host group with.