diff --git a/docs/v3/source/includes/resources/users/_create.md.erb b/docs/v3/source/includes/resources/users/_create.md.erb
index 10289de8d1f..56ac5d8bd54 100644
--- a/docs/v3/source/includes/resources/users/_create.md.erb
+++ b/docs/v3/source/includes/resources/users/_create.md.erb
@@ -73,8 +73,8 @@ Name     | Type     | Description
 **guid** | _string_ | Unique identifier for the user. For UAA users this will match the UAA user ID; in the case of UAA clients, this will match the UAA client ID |
 **username** | _string_ | Username of the user to be created. This can only be provided together with `origin`.                                                                                   |
 **origin** | _string_ | Origin of the user to be created. This can only be provided together with `username` and cannot be `uaa`.                                                               |
-**metadata.labels**   | [_label object_](#links) | Labels applied to the user                                                                                                                                              |
-**metadata.annotations** | [_annotation object_](#links) | Annotations added to the user                                                                                                                                           |
+**metadata.labels**   | [_label object_](#labels) | Labels applied to the user                                                                                                                                              |
+**metadata.annotations** | [_annotation object_](#annotations) | Annotations added to the user                                                                                                                                           |
 
 #### Permitted roles
 
diff --git a/docs/v3/source/includes/resources/users/_object.md.erb b/docs/v3/source/includes/resources/users/_object.md.erb
index 4f50eb6caf2..b89d2410bc6 100644
--- a/docs/v3/source/includes/resources/users/_object.md.erb
+++ b/docs/v3/source/includes/resources/users/_object.md.erb
@@ -15,6 +15,6 @@ Example User object
 | **username**                              | _string_                      | The name registered in UAA; will be `null` for UAA clients and non-UAA users                                                 |
 | **presentation_name**                     | _string_                      | The name displayed for the user; for UAA users, this is the same as the username. For UAA clients, this is the UAA client ID |
 | **origin**                                | _string_                      | The identity provider for the UAA user; will be `null` for UAA clients                                                       |
-| **metadata.labels**       | [_label object_](#links)      | Labels applied to the user                                                                                                   |
-| **metadata.annotations**  | [_annotation object_](#links) | Annotations added to the user                                                                                                |
+| **metadata.labels**       | [_label object_](#labels)      | Labels applied to the user                                                                                                   |
+| **metadata.annotations**  | [_annotation object_](#annotations) | Annotations added to the user                                                                                                |
 | **links**                                 | [_links object_](#links)      | Links to related resources                                                                                                   |
diff --git a/docs/v3/source/includes/resources/users/_update.md.erb b/docs/v3/source/includes/resources/users/_update.md.erb
index b415218e29c..538b59d3ada 100644
--- a/docs/v3/source/includes/resources/users/_update.md.erb
+++ b/docs/v3/source/includes/resources/users/_update.md.erb
@@ -37,8 +37,8 @@ Content-Type: application/json
 
 Name     | Type     | Description
 -------  | -------  | -----------
-**metadata.labels**   | [_label object_](#links) | Labels applied to the app                         |
-**metadata.annotations** | [_annotation object_](#links) | Annotations added to the user             |
+**metadata.labels**   | [_label object_](#labels) | Labels applied to the app                         |
+**metadata.annotations** | [_annotation object_](#annotations) | Annotations added to the user             |
 
 #### Permitted roles