Literal values include strings, numbers, TRUE, FALSE, NULL, and MISSING.

    N1QL supports the same literals as JSON, as defined by, with these exceptions:

    • In N1QL, "true", "false," and "null" are case-insensitive to be consistent with other N1QL keywords. In standard JSON, "true", "false," and "null" are case-sensitive.

    • "missing" is added as a literal expression, although it is not returned in final results. Missing is omitted from objects, and is converted to null in result arrays.

    • In N1QL single and double quotation marks can be used for strings. JSON supports only double quotation marks.

    Wherever a value is expected, either of two special values may appear: NULL (denoting an out-of-band value that is not comparable to any other value), and MISSING (denoting the absence of a value). Every value also has a "truth" value; these truth value conversions are explained in Boolean Logic.


    boolean ::= 'TRUE' | 'FALSE'
    Syntax diagram

    Boolean propositions evaluate to TRUE and FALSE. These values are case-insensitive.


    number ::= '-'? integer fraction? exponent?
    Syntax diagram
    integer ::= [0-9] | [1-9] [0-9]+
    Syntax diagram
    fraction ::= '.' [0-9]+
    Syntax diagram
    exponent ::= ('e' | 'E') ('-' | '+')? [0-9]+
    Syntax diagram

    Numbers can be either signed or unsigned integers with an optional fractional component and an optional exponent. If the integer component has more than one digit, the number should not start with a leading zero.


    string ::= '"' char* '"' | "'" char* "'"
    Syntax diagram
    char ::= unicode-character |
             '\' ('\' | '/' | 'b' | 'f' | 'n' | 'r' | 't' | 'u' hex hex hex hex )
    Syntax diagram
    hex ::= [0-9a-fA-F]
    Syntax diagram

    Strings can be either Unicode characters or escaped characters.


    null ::= 'NULL'
    Syntax diagram

    The literal NULL represents an empty value. This value is case-insensitive.


    missing ::= 'MISSING'
    Syntax diagram

    The MISSING literal is specific to N1QL and represents a missing name-value pair in a document. This value is case-insensitive.