diff --git a/docs/integrations-in-rancher/opa-gatekeeper.md b/docs/integrations-in-rancher/opa-gatekeeper.md
index f2185dff685..cea9732b36c 100644
--- a/docs/integrations-in-rancher/opa-gatekeeper.md
+++ b/docs/integrations-in-rancher/opa-gatekeeper.md
@@ -6,6 +6,8 @@ title: OPA Gatekeeper
   <link rel="canonical" href="https://ranchermanager.docs.rancher.com/integrations-in-rancher/opa-gatekeeper"/>
 </head>
 
+<DeprecationOPAGatekeeper link="kubewarden" />
+
 To ensure consistency and compliance, every organization needs the ability to define and enforce policies in its environment in an automated way. [OPA (Open Policy Agent)](https://www.openpolicyagent.org/) is a policy engine that facilitates policy-based control for cloud native environments. Rancher provides the ability to enable OPA Gatekeeper in Kubernetes clusters, and also installs a couple of built-in policy definitions, which are also called constraint templates.
 
 OPA provides a high-level declarative language that lets you specify policy as code and ability to extend simple APIs to offload policy decision-making.
diff --git a/docs/reference-guides/rancher-cluster-tools.md b/docs/reference-guides/rancher-cluster-tools.md
index ca037f533de..5221e0f150e 100644
--- a/docs/reference-guides/rancher-cluster-tools.md
+++ b/docs/reference-guides/rancher-cluster-tools.md
@@ -41,8 +41,11 @@ For more information, refer to the monitoring documentation [here.](../integrati
 Rancher's integration with Istio was improved in Rancher v2.5.
 
 For more information, refer to the Istio documentation [here.](../integrations-in-rancher/istio/istio.md)
+
 ## OPA Gatekeeper
 
+<DeprecationOPAGatekeeper link="../integrations-in-rancher/kubewarden" />
+
 [OPA Gatekeeper](https://github.com/open-policy-agent/gatekeeper) is an open-source project that provides integration between OPA and Kubernetes to provide policy control via admission controller webhooks. For details on how to enable Gatekeeper in Rancher, refer to the [OPA Gatekeeper section.](../integrations-in-rancher/opa-gatekeeper.md)
 
 ## CIS Scans
diff --git a/shared-files/_deprecation-opa-gatekeeper.md b/shared-files/_deprecation-opa-gatekeeper.md
new file mode 100644
index 00000000000..3a88f57b0d6
--- /dev/null
+++ b/shared-files/_deprecation-opa-gatekeeper.md
@@ -0,0 +1,5 @@
+:::warning
+
+OPA Gatekeeper is deprecated and will be removed in a future release. As a replacement for OPA Gatekeeper, consider switching to <a href={props.link}>Kubewarden</a>.
+
+:::
diff --git a/src/theme/MDXComponents.js b/src/theme/MDXComponents.js
index a3ad9fedc5d..540ac390d56 100644
--- a/src/theme/MDXComponents.js
+++ b/src/theme/MDXComponents.js
@@ -7,6 +7,7 @@ import TabItem from '@theme/TabItem';
 import { CardSection, Card } from '../components/CardComponents';
 
 import CNIPopularityTable from '/shared-files/_cni-popularity.md';
+import DeprecationOPAGatekeeper from '/shared-files/_deprecation-opa-gatekeeper.md';
 
 export default {
   // Re-use the default mapping
@@ -19,4 +20,5 @@ export default {
   Card,
 
   CNIPopularityTable,
+  DeprecationOPAGatekeeper,
 };
diff --git a/versioned_docs/version-2.8/integrations-in-rancher/opa-gatekeeper.md b/versioned_docs/version-2.8/integrations-in-rancher/opa-gatekeeper.md
index f2185dff685..cea9732b36c 100644
--- a/versioned_docs/version-2.8/integrations-in-rancher/opa-gatekeeper.md
+++ b/versioned_docs/version-2.8/integrations-in-rancher/opa-gatekeeper.md
@@ -6,6 +6,8 @@ title: OPA Gatekeeper
   <link rel="canonical" href="https://ranchermanager.docs.rancher.com/integrations-in-rancher/opa-gatekeeper"/>
 </head>
 
+<DeprecationOPAGatekeeper link="kubewarden" />
+
 To ensure consistency and compliance, every organization needs the ability to define and enforce policies in its environment in an automated way. [OPA (Open Policy Agent)](https://www.openpolicyagent.org/) is a policy engine that facilitates policy-based control for cloud native environments. Rancher provides the ability to enable OPA Gatekeeper in Kubernetes clusters, and also installs a couple of built-in policy definitions, which are also called constraint templates.
 
 OPA provides a high-level declarative language that lets you specify policy as code and ability to extend simple APIs to offload policy decision-making.
diff --git a/versioned_docs/version-2.8/reference-guides/rancher-cluster-tools.md b/versioned_docs/version-2.8/reference-guides/rancher-cluster-tools.md
index ca037f533de..5221e0f150e 100644
--- a/versioned_docs/version-2.8/reference-guides/rancher-cluster-tools.md
+++ b/versioned_docs/version-2.8/reference-guides/rancher-cluster-tools.md
@@ -41,8 +41,11 @@ For more information, refer to the monitoring documentation [here.](../integrati
 Rancher's integration with Istio was improved in Rancher v2.5.
 
 For more information, refer to the Istio documentation [here.](../integrations-in-rancher/istio/istio.md)
+
 ## OPA Gatekeeper
 
+<DeprecationOPAGatekeeper link="../integrations-in-rancher/kubewarden" />
+
 [OPA Gatekeeper](https://github.com/open-policy-agent/gatekeeper) is an open-source project that provides integration between OPA and Kubernetes to provide policy control via admission controller webhooks. For details on how to enable Gatekeeper in Rancher, refer to the [OPA Gatekeeper section.](../integrations-in-rancher/opa-gatekeeper.md)
 
 ## CIS Scans