:_mod-docs-content-type: ASSEMBLY
[id="crd-upgrade-safety"]
= Custom resource definition (CRD) upgrade safety
include::_attributes/common-attributes.adoc[]
:context: crd-upgrade-safety

toc::[]

When you update a custom resource definition (CRD) that is provided by a cluster extension, {olmv1-first} runs a CRD upgrade safety preflight check to ensure backwards compatibility with previous versions of that CRD. The CRD update must pass the validation checks before the change is allowed to progress on a cluster.

[role="_additional-resources"]
.Additional resources
* xref:../../extensions/ce/managing-ce.adoc#olmv1-updating-an-operator_managing-ce[Updating a cluster extension]

include::modules/prohibited-crd-upgrades.adoc[leveloffset=+1]

include::modules/allowed-crd-upgrades.adoc[leveloffset=+1]

include::modules/disabling-crd-preflight.adoc[leveloffset=+1]

include::modules/examples-unsafe-crd-upgrades.adoc[leveloffset=+1]
