diff --git a/docs/private-networks/how-to/use-permissioning/onchain.md b/docs/private-networks/how-to/use-permissioning/onchain.md
index 054062f904..83421e2198 100644
--- a/docs/private-networks/how-to/use-permissioning/onchain.md
+++ b/docs/private-networks/how-to/use-permissioning/onchain.md
@@ -50,7 +50,7 @@ If you change your network configuration, you may need to update the node allowl
 
 ## Specify the permissioning contract interface version
 
-Use the [`--permissions-nodes-contract-version`](../../reference/cli/options.md#permissions-nodes-contract-version) command line option to specify the version of the [permissioning contract interface](../../concepts/permissioning/onchain.md#permissioning-contracts). The default is 1.
+Use the [`--permissions-nodes-contract-version`](../../reference/cli/options.md#permissions-nodes-contract-version-deprecated) command line option to specify the version of the [permissioning contract interface](../../concepts/permissioning/onchain.md#permissioning-contracts). The default is 1.
 
 Specify the contract interface version that maps to the version of the [Enterprise Ethereum Alliance Client Specification](https://entethalliance.org/technical-specifications/) the contract interface implements.
 
diff --git a/docs/private-networks/reference/cli/options.md b/docs/private-networks/reference/cli/options.md
index 56c0d2ec1f..7cc8cfd77b 100644
--- a/docs/private-networks/reference/cli/options.md
+++ b/docs/private-networks/reference/cli/options.md
@@ -139,13 +139,7 @@ permissions-accounts-config-file-enabled=true
 
 </Tabs>
 
-Enables or disables file-based account level permissions. The default is `false`. (Deprecated)
-
-:::caution
-
-Onchain permissioning is deprecated in Besu version 24.11.0 and later. Please read this [blog post](https://www.lfdecentralizedtrust.org/blog/sunsetting-tessera-and-simplifying-hyperledger-besu) for more context on the rationale behind this decision as well as alternative options.
-
-:::
+Enables or disables file-based account level permissions. The default is `false`.
 
 ### `permissions-accounts-contract-address` (Deprecated)
 
@@ -227,6 +221,12 @@ permissions-accounts-contract-enabled=true
 
 Enables or disables contract-based [onchain account permissioning](../../concepts/permissioning/onchain.md). The default is `false`.
 
+:::caution
+
+Onchain permissioning is deprecated in Besu version 24.11.0 and later. Please read this [blog post](https://www.lfdecentralizedtrust.org/blog/sunsetting-tessera-and-simplifying-hyperledger-besu) for more context on the rationale behind this decision as well as alternative options.
+
+:::
+
 ### `permissions-nodes-config-file`
 
 <Tabs>
@@ -393,6 +393,12 @@ permissions-nodes-contract-enabled=true
 
 Enables or disables contract-based [onchain node permissioning](../../concepts/permissioning/onchain.md). The default is `false`.
 
+:::caution
+
+Onchain permissioning is deprecated in Besu version 24.11.0 and later. Please read this [blog post](https://www.lfdecentralizedtrust.org/blog/sunsetting-tessera-and-simplifying-hyperledger-besu) for more context on the rationale behind this decision as well as alternative options.
+
+:::
+
 ### `permissions-nodes-contract-version` (Deprecated)
 
 <Tabs>