diff --git a/content/master/concepts/environment-configs.md b/content/master/concepts/environment-configs.md index 85366028..4e6339e2 100644 --- a/content/master/concepts/environment-configs.md +++ b/content/master/concepts/environment-configs.md @@ -235,10 +235,18 @@ spec: # Removed for brevity ``` -Crossplane evaluates label selectors in order, so if a label set as optional -isn't found, but if you already defined an explicit value for it, it uses that -{{}}default value{{}} -instead. +Set a default value for an optional label by setting the +{{}}value{{}} for the +{{}}key{{}} first, then +define the +{{}}Optional{{}} label. + +For example, this Composition defines +{{}}value: my-default-value{{}} +for the key {{}}my-second-label-key{{}}. +If the label +{{}}my-second-label-key{{}} +exists, Crossplane uses the value from the label instead. ```yaml {label="byLabelOptionalDefault",copy-lines="all"} apiVersion: apiextensions.crossplane.io/v1 @@ -265,6 +273,12 @@ spec: # Removed for brevity ``` +{{}} +Crossplane applies values in order. The value of the last key defined always takes precedence. + +Defining the default value _after_ the label always overwrites the label +value. +{{< /hint >}} #### Manage selector results