diff --git a/website/content/docs/commands/volume/register.mdx b/website/content/docs/commands/volume/register.mdx
index 47bd3ff3e5eb..39b0b39c9394 100644
--- a/website/content/docs/commands/volume/register.mdx
+++ b/website/content/docs/commands/volume/register.mdx
@@ -67,6 +67,19 @@ the exact section.
 The volume specification is documented in the [Volume
 Specification][volume_specification] page.
 
+Not all fields can be updated after the volume is registered:
+
+* The `capacity_min` and `capacity_max` fields can be updated, so long as the
+  volumes existing capacity fits within that range. The actual capacity of the
+  volume is unchanged.
+* The `capability` blocks can be added or removed, but only if the capability is
+  not currently in use by a mounted volume.
+* The `mount_options` block can be updated if the volume is not in use.
+* The `secrets` block can be updated.
+* The `context` block can be updated. The values for this field are typically
+  provided by the CSI plugin, and should not be updated unless recommended by
+  the CSI plugin's documentation.
+
 [csi]: https://github.com/container-storage-interface/spec
 [csi_plugins_internals]: /nomad/docs/concepts/plugins/csi#csi-plugins
 [volume_specification]: /nomad/docs/other-specifications/volume
diff --git a/website/content/docs/other-specifications/volume/index.mdx b/website/content/docs/other-specifications/volume/index.mdx
index e094b863be22..f1a2de11499b 100644
--- a/website/content/docs/other-specifications/volume/index.mdx
+++ b/website/content/docs/other-specifications/volume/index.mdx
@@ -157,6 +157,22 @@ You should not set the [`snapshot_id`](#snapshot_id), [`clone_id`](#clone_id),
 And you should not set the [`external_id`](#external_id) or
 [`context`](#context) fields on **volume creation**.
 
+## Updating a Volume Definition
+
+The `volume register` command allows updating a volume definition. But not all
+fields can be updated after the volume is registered:
+
+* The `capacity_min` and `capacity_max` fields can be updated, so long as the
+  volumes existing capacity fits within that range. The actual capacity of the
+  volume is unchanged.
+* The `capability` blocks can be added or removed, but only if the capability is
+  not currently in use by a mounted volume.
+* The `mount_options` block can be updated if the volume is not in use.
+* The `secrets` block can be updated.
+* The `context` block can be updated. The values for this field are typically
+  provided by the CSI plugin, and should not be updated unless recommended by
+  the CSI plugin's documentation.
+
 ## Examples
 
 ### Volume registration