diff --git a/docs/content/migration/v3.md b/docs/content/migration/v3.md
index 1364ff6e8..64ac460e5 100644
--- a/docs/content/migration/v3.md
+++ b/docs/content/migration/v3.md
@@ -78,6 +78,17 @@ Please use the `disableClusterScopeResources` option instead to avoid cluster sc
 
 ## v3.1 to v3.2
 
+### Kubernetes CRD Provider
+
+Starting with v3.2, the CRDs has been updated on [TraefikService](../routing/services#mirroring-service) (PR [#11032](https://github.com/traefik/traefik/pull/11032)) and on [RateLimit](../middlewares/http/ratelimit) & [InFlightReq](../middlewares/http/inflightreq) middlewares (PR [#9747](https://github.com/traefik/traefik/pull/9747)).
+
+This update adds only new optional fields.
+CRDs can be updated with this command:
+
+```shell
+kubectl apply -f https://raw.githubusercontent.com/traefik/traefik/v3.2/docs/content/reference/dynamic-configuration/kubernetes-crd-definition-v1.yml
+```
+
 ### Kubernetes Gateway Provider Standard Channel
 
 Starting with v3.2, the Kubernetes Gateway Provider now supports [GRPCRoute](https://gateway-api.sigs.k8s.io/api-types/grpcroute/).