diff --git a/website/content/en/docs/upgrading/v1-migration.md b/website/content/en/docs/upgrading/v1-migration.md
index 7f0d3418cdb4..b21274d35172 100644
--- a/website/content/en/docs/upgrading/v1-migration.md
+++ b/website/content/en/docs/upgrading/v1-migration.md
@@ -76,7 +76,9 @@ The upgrade guide will first require upgrading to your latest patch version prio
         --set webhook.serviceNamespace="${KARPENTER_NAMESPACE}" \
         --set webhook.port=8443
     ```
-
+{{% alert title="Note" color="warning" %}}
+If you receive a `label validation error` or `annotation validation error` consult the [troubleshooting guide]({{<ref "../troubleshooting/#helm-error-when-installing-the-karpenter-crd-chart" >}}) for steps to resolve. 
+{{% /alert %}}
 
 7. Upgrade Karpenter to the latest patch version of your current minor version's. At the end of this step, conversion webhooks will run but will not convert any version.
 
@@ -125,6 +127,10 @@ The upgrade guide will first require upgrading to your latest patch version prio
         --set webhook.port=8443
     ```
 
+{{% alert title="Note" color="warning" %}}
+If you receive a `label validation error` or `annotation validation error` consult the [troubleshooting guide]({{<ref "../troubleshooting/#helm-error-when-installing-the-karpenter-crd-chart" >}}) for steps to resolve. 
+{{% /alert %}}
+
 11. Upgrade Karpenter to the new version. At the end of this step, conversion webhooks run to convert the Karpenter CRDs to v1.
 
     ```bash
diff --git a/website/content/en/preview/upgrading/v1-migration.md b/website/content/en/preview/upgrading/v1-migration.md
index 7f0d3418cdb4..b21274d35172 100644
--- a/website/content/en/preview/upgrading/v1-migration.md
+++ b/website/content/en/preview/upgrading/v1-migration.md
@@ -76,7 +76,9 @@ The upgrade guide will first require upgrading to your latest patch version prio
         --set webhook.serviceNamespace="${KARPENTER_NAMESPACE}" \
         --set webhook.port=8443
     ```
-
+{{% alert title="Note" color="warning" %}}
+If you receive a `label validation error` or `annotation validation error` consult the [troubleshooting guide]({{<ref "../troubleshooting/#helm-error-when-installing-the-karpenter-crd-chart" >}}) for steps to resolve. 
+{{% /alert %}}
 
 7. Upgrade Karpenter to the latest patch version of your current minor version's. At the end of this step, conversion webhooks will run but will not convert any version.
 
@@ -125,6 +127,10 @@ The upgrade guide will first require upgrading to your latest patch version prio
         --set webhook.port=8443
     ```
 
+{{% alert title="Note" color="warning" %}}
+If you receive a `label validation error` or `annotation validation error` consult the [troubleshooting guide]({{<ref "../troubleshooting/#helm-error-when-installing-the-karpenter-crd-chart" >}}) for steps to resolve. 
+{{% /alert %}}
+
 11. Upgrade Karpenter to the new version. At the end of this step, conversion webhooks run to convert the Karpenter CRDs to v1.
 
     ```bash
diff --git a/website/content/en/v1.0/upgrading/v1-migration.md b/website/content/en/v1.0/upgrading/v1-migration.md
index 7f0d3418cdb4..b21274d35172 100644
--- a/website/content/en/v1.0/upgrading/v1-migration.md
+++ b/website/content/en/v1.0/upgrading/v1-migration.md
@@ -76,7 +76,9 @@ The upgrade guide will first require upgrading to your latest patch version prio
         --set webhook.serviceNamespace="${KARPENTER_NAMESPACE}" \
         --set webhook.port=8443
     ```
-
+{{% alert title="Note" color="warning" %}}
+If you receive a `label validation error` or `annotation validation error` consult the [troubleshooting guide]({{<ref "../troubleshooting/#helm-error-when-installing-the-karpenter-crd-chart" >}}) for steps to resolve. 
+{{% /alert %}}
 
 7. Upgrade Karpenter to the latest patch version of your current minor version's. At the end of this step, conversion webhooks will run but will not convert any version.
 
@@ -125,6 +127,10 @@ The upgrade guide will first require upgrading to your latest patch version prio
         --set webhook.port=8443
     ```
 
+{{% alert title="Note" color="warning" %}}
+If you receive a `label validation error` or `annotation validation error` consult the [troubleshooting guide]({{<ref "../troubleshooting/#helm-error-when-installing-the-karpenter-crd-chart" >}}) for steps to resolve. 
+{{% /alert %}}
+
 11. Upgrade Karpenter to the new version. At the end of this step, conversion webhooks run to convert the Karpenter CRDs to v1.
 
     ```bash