Python 3 reference · List Methods

Python List remove() Method

Remove the first item equal to a value. Raises ValueError if the value is not in the list.

Create a free account to save this page, take notes and track your progress. Sign in

Syntax

list.remove(value)

Parameter	Description
`value`	The value to remove.

None.

Remove the first matchTry it yourself

pets = ["cat", "dog", "cat"]
pets.remove("cat")
print(pets)

Output

['dog', 'cat']

Remove every occurrenceTry it yourself

nums = [1, 2, 1, 3, 1]
nums = [n for n in nums if n != 1]  # remove every match
print(nums)

Output

[2, 3]

Don't remove items from a list while looping over it; build a new list with a comprehension instead.

Version	Change
Python 3.0	Added

list.pop() · Remove and return the item at a position, the last item by default. Raises IndexError on an empty list.
list.clear() · Remove every item from the list in place, leaving an empty list. Other references see the change too.
set.discard() · Remove an element if it is present; do nothing if it isn't. The no-error version of remove().
Python Lists · tutorial

Was this page helpful?