Annotations Reference

The following annotations are used to configure kpt features:

AnnotationDescription
config.kubernetes.io/depends-onspecifies one or more resource dependencies
config.kubernetes.io/apply-time-mutationspecifies one or more substitutions to make at apply time using dependencies as input
config.kubernetes.io/local-configspecifies a resource to be skipped when applying

The following annotations are used by kpt internally:

AnnotationDescription
internal.config.kubernetes.io/pathspecifies the resource’s file path when formatted as a ResourceList
internal.config.kubernetes.io/indexspecifies the index of the resource in a file when formatted as a ResourceList
config.kubernetes.io/merge-sourcespecifies the source of the resource during a three way merge
Last modified June 16, 2025: Move docs to hugo (#4215) (2f0d4026)