Python None: How to Represent a Null Value

Python does not use a keyword named null. Instead, it uses the singleton object None to represent the absence of a value. You will learn how to assign, test, and use None safely in Python programs.

Python's equivalent of a null value is None.

result = None

None is a special built-in object that means no value is present, a value is unknown, or an operation has no meaningful result. Its type is NoneType.

print(type(None))  # <class 'NoneType'>

There is only one None object in a Python program. This is why Python code tests for it with identity operators:

if result is None:
    print("No result is available")

None matters because many functions, APIs, and optional variables need a clear way to distinguish “there is no value” from values such as 0, "", or False.

Think of a variable as a labeled box.

• score = 0 means the box contains the number zero.
• name = "" means the box contains an empty piece of text.
• active = False means the box contains a false value.
• email = None means the box currently has no email value at all.

None is not an empty string, zero, or False. It is a specific marker that says, “there is nothing here yet.”

Use None with a capital N and lowercase one.

user_address = None

Test whether a value is None with is or is not:

user_address = None

if user_address is None:
    print("Address has not been provided.")
else:
    print(user_address)

Use is not None when a value must be present before you use it:

age = 21

if age is not None:
    print(f"Age: {age}")

Many Python functions return None when they perform an action instead of calculating and returning a new value:

Consider this example:

def find_discount(code):
    discounts = {"SAVE10": 10, "SAVE20": 20}
    return discounts.get(code)

amount = find_discount("WELCOME")

if amount is None:
    print("Discount code was not found.")
else:
    print(f"Discount: {amount}%")

Step by step:

1. find_discount("WELCOME") runs.
2. The dictionary contains SAVE10 and SAVE20, but not WELCOME.
3. dict.get() returns None when a key is missing and no fallback value was provided.
4. amount is assigned None.
5. amount is None evaluates to True.
6. The program prints

None is common whenever data may be optional or unavailable.

• Database records: A user may not have supplied a phone number yet.

  phone_number = None
  

• API data: A response may omit an optional field such as a profile image.

  avatar_url = response.get("avatar_url")
  

• Search functions: A function may return None when it cannot find an item.

  product = find_product(product_id)
  

• Optional function arguments: None can mean “use the default behavior.”

  def connect(timeout=None):
      if timeout is None:
          timeout = 30
  

• In-place operations: Methods such as list.sort() and list.append() return None because they modify an existing object.

In real projects, developers use None to model optional values and to make decisions before using data.

Guard clauses

Return early when a required value is missing:

def send_receipt(email):
    if email is None:
        return False

    print(f"Sending receipt to {email}")
    return True

Validation

Check that required input was provided:

def create_account(username, password):
    if username is None or password is None:
        raise ValueError("Username and password are required")

Defaults without overwriting valid false-like values

Use an explicit None check when 0, False, or an empty string are valid inputs:

Writing null, NULL, or none

Python is case-sensitive and has no null keyword.

# Broken: NameError
value = null

Use None:

value = None

Comparing with == None

This often works, but is None is the recommended and clearest form. Equality can be customized by objects, while identity checks whether the value is the actual singleton None.

# Avoid
if value == None:
    pass

# Prefer
if value is None:
    pass

Treating None as the same as False, , or

is versus ==

# Represent no value
value = None

# Preferred checks
if value is None:
    pass

if value is not None:
    pass

# Optional argument pattern
def greet(name=None):
    if name is None:
        name = "Guest"
    return f"Hello, {name}!"

# Safe mutable default pattern
def add_item(item, items=None):
    if items is None:
        items = []
    items.append(item)
    return items

• Python uses None, not null.
• None has type NoneType.
• There is only one None object.
• Prefer and .

Is None the same as null in Python?

Conceptually, yes: None is Python's standard value for representing no value. Python does not have a null keyword.

Why should I use is None instead of == None?

None is a single shared object. is None directly checks for that object and is the standard Python style.

Is None false in an if statement?

Yes, None is false-like, so if None: does not run. However, it is distinct from False, 0, and empty collections.

Can a function return None?

Yes. A function with no return statement returns None automatically. Functions may also explicitly use return None.

• Python variables — Variables can refer to None or to an actual object.
• Boolean truthiness — None is false-like, but it is not the same value as False.
• Identity operators (is and is not) — These are the correct operators for checking None.
• Equality operators (== and !=) — Useful for value comparison, but generally not the preferred way to test for None.
• Functions and return values — Functions without an explicit return produce None.
• Optional function arguments — None is commonly used to indicate that an argument was not supplied.
• Dictionaries and dict.get() — get() can return None for missing keys.
• Type hints and Optional — Type hints can document values that may be a type or None.