How to Check Whether an Object Is Iterable in Python

By the end of this page, you will know what iteration means in Python, why checking for __iter__ alone is incomplete, and how to reliably test an object by calling iter() safely.

An iterable is an object that Python can loop over with for.

for item in value:
    print(item)

Examples include lists, tuples, strings, dictionaries, sets, files, generators, and many custom objects.

Python determines whether an object can be iterated by attempting to create an iterator from it:

iterator = iter(value)

If this succeeds, value is iterable. If it raises TypeError, it is not iterable.

Many iterable objects implement __iter__(). However, Python also supports a legacy sequence mechanism: an object can be iterable when it provides indexed access through __getitem__() starting at index 0, even if it has no __iter__ method. Therefore, hasattr(value, "__iter__") is not a complete test.

The most reliable general-purpose answer is to use Python's actual iteration protocol: call iter() and handle TypeError.

Think of an iterable as a book that Python knows how to read one item at a time.

• iter(book) asks Python to open the book at its first readable item.
• The returned iterator is the bookmark that remembers the current position.
• next(iterator) reads the next item and moves the bookmark.
• When there are no items left, Python raises StopIteration.

Checking only for __iter__ is like checking whether a book has a particular kind of cover. Usually that works, but Python can also read some objects through another supported mechanism: numbered pages supplied by __getitem__. Trying iter() checks whether Python can actually open and read the object.

Use iter() inside try/except when you need a reliable behavioral check.

def is_iterable(value):
    try:
        iter(value)
        return True
    except TypeError:
        return False

print(is_iterable([1, 2, 3]))   # True
print(is_iterable("hello"))     # True
print(is_iterable(42))          # False
print(is_iterable(None))        # False

iter(value) follows the same rules that a for loop uses. A list and string produce iterators, while an integer and None do not.

If you are checking whether an object explicitly follows the modern iterable interface, use collections.abc.Iterable:

Consider this function call:

def is_iterable(value):
    try:
        iter(value)
        return True
    except TypeError:
        return False

result = is_iterable("cat")

Step by step:

1. is_iterable receives the string "cat" as value.
2. iter(value) asks Python for an iterator over the string.
3. Python successfully creates a string iterator.
4. No exception occurs, so the function returns True.
5. result becomes True.

Now with an integer:

result = is_iterable(10)

1. iter(10) is attempted.
2. Integers do not provide a valid iteration mechanism.
3. Python raises TypeError.

Testing iterability is useful when a function accepts either one value or a collection of values.

Accept one tag or several tags

def normalize_tags(tags):
    if isinstance(tags, str):
        return [tags]

    try:
        return list(tags)
    except TypeError:
        return [tags]

print(normalize_tags("python"))             # ['python']
print(normalize_tags(["python", "testing"])) # ['python', 'testing']

Strings need special handling because they are iterable character by character, but an API may intend a string to be one value.

Validate data before processing

A data-processing function may require a sequence of records:

def process_records(records):
    try:
        iterator = iter(records)
    except TypeError:
        raise TypeError("records must be an iterable") from None

     record  iterator:
        (record)

In real projects, developers often avoid a separate is_iterable() check when they are about to iterate anyway. Instead, they attempt the required operation and provide a useful error if it fails.

Validate at a function boundary

def total(numbers):
    try:
        return sum(numbers)
    except TypeError as error:
        raise TypeError("numbers must contain numeric iterable values") from error

Use a guard clause for special iterable types

Strings, bytes, and dictionaries are iterable, but their iteration behavior may not match an application's meaning.

from collections.abc import Iterable

def display_items(value):
    if isinstance(value, (str, bytes)):
        return [value]

    if not isinstance(value, Iterable):
        return [value]

    return list(value)

Preserve one-pass iterators

Checking only for __iter__

hasattr(my_obj, "__iter__")

This can miss objects that are iterable through __getitem__() rather than __iter__().

class LegacySequence:
    def __getitem__(self, index):
        if index >= 3:
            raise IndexError
        return index * 10

value = LegacySequence()

print(hasattr(value, "__iter__"))  # False
print(list(value))                  # [0, 10, 20]

Prefer iter(value) in a try/except TypeError block for a runtime check.

Assuming an iterable is reusable

Generators are iterable, but they are usually consumed after one pass.

# Reliable runtime test
def is_iterable(value):
    try:
        iter(value)
        return True
    except TypeError:
        return False

# Interface-oriented check
from collections.abc import Iterable

isinstance(value, Iterable)

• iter(value) is the same protocol a for loop relies on.
• Catch TypeError, not every exception.
• Do not rely solely on hasattr(value, "__iter__").
• Strings, bytes, and dictionaries are iterable; decide whether that is desirable for your API.
• iter(value) does not consume items.
• next(iter(value)) can consume an item when value is already an iterator.
• Iterators are iterable, but some are one-pass objects such as generators.

Is there a built-in isiterable() function in Python?

No. The usual runtime test is iter(value) inside try/except TypeError.

Is hasattr(obj, "__iter__") a reliable iterable check?

No. It can miss objects that Python iterates using __getitem__(), and the presence of an attribute does not guarantee a successful iteration operation.

What is the recommended way to check if an object is iterable?

Use iter(obj) and catch TypeError when you need to know whether a for loop could iterate over it.

Are strings iterable in Python?

Yes. Iterating over a string yields one-character strings. Handle strings separately if your code should treat one string as a single value.

Is a dictionary iterable?

Yes. Iterating over a dictionary yields its keys. Use .values() for values or .items() for key-value pairs.

What is the difference between an iterable and an iterator?

An iterable can create an iterator. An iterator additionally tracks progress and provides items through next().

• For loops — for loops use the iteration protocol automatically.
• Iterators — iterators keep state and return values one at a time with next().
• Generators — generators are memory-efficient, usually one-pass iterators.
• collections.abc — abstract base classes such as Iterable, Iterator, and Sequence support interface checks.
• Duck typing — Python often relies on whether an object can perform an operation instead of its declared type.
• Exception handling — try/except TypeError is a practical example of validating behavior.
• Sequences — lists, tuples, strings, and some custom indexed objects are common iterable sequences.