Language: Data types: Booleans

Booleans are one-bit values, representing true or false.

The condition of an “if” statement expects an expression that resolves to a boolean value. All of Puppet’s comparison operators resolve to boolean values, as do many functions.


The boolean data type has two possible values: true and false. Literal booleans must be one of these two bare words (that is, not quoted).

Automatic conversion to boolean

If a non-boolean value is used where a boolean is required:

  • The undef value is converted to boolean false.
  • All other values are converted to boolean true.

Notably, this means the string values "" (zero-length string) and "false" both resolve to true.

If you want to convert other values to booleans with more permissive rules (0 as false, "false" as false, etc.), the puppetlabs-stdlib module includes str2bool and num2bool functions.

The Boolean data type

The data type of boolean values is Boolean.

It matches only the values true or false, and accepts no parameters.

You can use abstract types to match values that might be boolean or might have some other value. For example, Optional[Boolean] will match true, false, or undef. Variant[Boolean, Enum["true", "false"]] will match stringified booleans as well as true booleans.