diff --git a/docs/docsite/rst/userguide/users.rst b/docs/docsite/rst/userguide/users.rst
index 1132cbfb00cd..772e6caec58a 100644
--- a/docs/docsite/rst/userguide/users.rst
+++ b/docs/docsite/rst/userguide/users.rst
@@ -48,6 +48,7 @@ Three types of Users can be assigned:
 Once the user is successfully created, the **User** dialog opens for that newly created User. 
 
 .. |edit-button| image:: ../common/images/edit-button.png
+                 :alt: Edit button
 
 .. image:: ../common/images/users-edit-user-form.png
    :alt: Edit User Form
@@ -93,7 +94,9 @@ Users - Organizations
 This displays the list of organizations of which that user is a member. This list may be searched by Organization Name or Description.
 Organization membership cannot be modified from this display panel.
 
-|Users - Organizations list for example user| image:: ../common/images/users-organizations-list-for-example-user.png
+|Users - Organizations list for example user|
+
+.. |Users - Organizations list for example user| image:: ../common/images/users-organizations-list-for-example-user.png
                                               :alt: Users - Organizations list for example user
 
 Users - Teams
@@ -106,7 +109,9 @@ This displays the list of teams of which that user is a member. This list may be
 
 Until a Team has been created and the user has been assigned to that team, the assigned Teams Details for the User appears blank.
 
-|Users - teams list for example user| image:: ../common/images/users-teams-list-for-example-user.png
+|Users - teams list for example user|
+
+.. |Users - teams list for example user| image:: ../common/images/users-teams-list-for-example-user.png
                                       :alt: Users - teams list for example user - empty
 
 .. _ug_users_roles:
@@ -126,7 +131,9 @@ The set of permissions assigned to this user (role-based access controls) that p
 
 This screen displays a list of the roles that are currently assigned to the selected User and can be sorted and searched by **Name**, **Type**, or **Role**.
 
-|Users - permissions list for example user| image:: ../common/images/users-permissions-list-for-example-user.png
+|Users - permissions list for example user|
+
+.. |Users - permissions list for example user| image:: ../common/images/users-permissions-list-for-example-user.png
                                             :alt: Users - permissions list for example user
 
 .. _ug_users_permissions: