How to Find the Index of an Item in a Python List

By the end of this page, you will understand how to find the position of a value in a Python list using list.index(), what happens when the value is missing, and how this is commonly handled in real Python code.

In Python, a list index is the numeric position of an element inside a list. Indexes start at 0, not 1.

For example:

items = ["foo", "bar", "baz"]

The positions are:

• "foo" → index 0
• "bar" → index 1
• "baz" → index 2

To find the index of a value, Python lists provide the built-in method:

list.index(value)

Example:

items = ["foo", "bar", "baz"]
print(items.index("bar"))

Output:

1

This matters because many programming tasks depend on knowing where something appears in a sequence:

Think of a list like a row of numbered lockers.

["foo", "bar", "baz"]

The lockers are numbered:

• locker 0 has "foo"
• locker 1 has "bar"
• locker 2 has "baz"

When you call items.index("bar"), you are asking:

"Which locker number contains "bar"?"

Python searches from left to right and returns the first matching locker number.

The basic syntax is:

my_list.index(value)

You can also search within part of a list:

my_list.index(value, start, end)

Basic example

items = ["foo", "bar", "baz"]
index = items.index("bar")
print(index)

Output:

1

index() returns the position of the first matching element.

Example with numbers

numbers = [10, 20, 30, 40]
print(numbers.index(30))

Output:

2

Example with duplicate values

letters = ["a", , , ]
(letters.index())

Consider this code:

items = ["foo", "bar", "baz"]
result = items.index("bar")
print(result)

Step by step:

1. Python creates a list:

   ["foo", "bar", "baz"]
   

2. The variable items now refers to that list.
3. Python evaluates:

   items.index("bar")
   

4. It checks elements from left to right:
   • index 0 → "foo" → not a match
   • index 1 → "bar" → match found
5. Python returns 1.
6. That value is stored in result.
7. print(result) displays:

   1
   

Here is another example showing failure:

Finding an item’s index is useful in many practical situations:

User interface selections

menu = ["Home", "Profile", "Settings"]
selected = "Profile"
position = menu.index(selected)

This can help highlight the active tab.

Data processing

columns = ["id", "name", "email"]
email_index = columns.index("email")

This is useful when reading CSV-like data where column positions matter.

Reordering items

tasks = ["todo", "doing", "done"]
current = tasks.index("doing")

A program can use the index to move an item forward or backward.

Validation rules

allowed_steps = ["start", "review", "publish"]
step_index = allowed_steps.index("review")

This can help compare workflow order.

Command-line tools and scripts

A script may search a list of arguments, options, or headers to find where a value appears before processing it.

In real projects, developers often use list.index() in small, focused ways rather than everywhere.

Common pattern: find and use position

fields = ["name", "email", "age"]
pos = fields.index("email")

This is common when mapping field names to column positions.

Guarding against missing values

If the item may not exist, developers usually avoid assuming success:

if "email" in fields:
    pos = fields.index("email")

This works, but note that it searches the list twice.

Error handling with try/except

try:
    pos = fields.index("email")
except ValueError:
    pos = None

This is common when missing data is expected.

Working with duplicates

When developers need all matching positions, they do not rely on index() alone:

Mistake 1: Forgetting that indexes start at 0

Broken expectation:

items = ["foo", "bar", "baz"]
print(items.index("bar"))  # beginner may expect 2

Actual result:

1

Python uses zero-based indexing.

Mistake 2: Calling index() for a value that is not present

Broken code:

items = ["foo", "bar", "baz"]
print(items.index("qux"))

This raises:

ValueError

Avoid this by handling the error:

try:
    print(items.index("qux"))
except ValueError:
    print("Not found")

Mistake 3: Assuming index() returns all matches

index() vs in

items = ["foo", "bar", "baz"]
print(  items)
(items.index())

items = ["foo", "bar", "baz"]
items.index("bar")   # 1

Syntax

my_list.index(value)
my_list.index(value, start)
my_list.index(value, start, end)

Rules

• Indexes start at 0
• index() returns the first match
• If the value is missing, Python raises ValueError
• Search happens from left to right

Safe pattern

try:
    i = my_list.index(value)
except ValueError:
    i = None

Get all matching indexes

[i for i, v in enumerate(my_list) if v == value]

Useful related tools

• in → check if a value exists
• enumerate() → loop with index and value

How do I find the index of an item in a Python list?

Use list.index():

items = ["foo", "bar", "baz"]
print(items.index("bar"))

What happens if the item is not in the list?

Python raises a ValueError. Use try/except if the value may be missing.

Does index() return the first or last match?

It returns the first matching index.

How do I find all indexes of the same value?

Use enumerate() with a list comprehension:

[i for i, v in enumerate(items) if v == "bar"]

Why is the index of the second item equal to 1?

Because Python uses zero-based indexing, so counting starts at 0.

Can I search only part of a list?

Yes:

• Python lists — A list is the data structure that stores ordered items by index.
• Zero-based indexing — Understanding indexing starts at 0 is essential for using index() correctly.
• List methods — index() is one of several useful built-in methods on lists.
• Membership testing with in — Useful when you only need to know whether a value exists.
• enumerate() — Lets you loop through both indexes and values.
• Exceptions and try/except — Important for handling ValueError when an item is not found.
• List comprehensions — Helpful for finding multiple matching indexes.