Selenium Locators: Finding the Element You Mean

The idea, in one line

A locator is your way of telling the browser which element you mean. Selenium reaches all of them through one class called By.

How you call it

Use driver.find_element(By.X, "value") for a single match. Use driver.find_elements(...) (note the s) for a list. If nothing matches, the list version just returns an empty list — it does not crash.

Selenium 4 gives you eight ways to point at an element:

• By.ID — the fastest and cleanest, when the element has one
• By.NAME — matches the name attribute, common on form fields
• By.CSS_SELECTOR — covers most real cases and reads more easily than XPath
• By.XPATH — the powerful one, for when you must select by visible text or walk to a parent
• By.CLASS_NAME, By.TAG_NAME, By.LINK_TEXT, By.PARTIAL_LINK_TEXT — the rest, for narrower jobs

See it work

from selenium import webdriver
from selenium.webdriver.common.by import By

driver = webdriver.Chrome()
driver.get("https://www.saucedemo.com/")

# One element, found by its name attribute
driver.find_element(By.NAME, "user-name").send_keys("standard_user")
driver.find_element(By.NAME, "password").send_keys("secret_sauce")

# A CSS selector aimed at a stable test hook
driver.find_element(By.CSS_SELECTOR, "[data-test='login-button']").click()

# find_elements gives a list -> handy for counting
items = driver.find_elements(By.CLASS_NAME, "inventory_item")
print(len(items), "products listed")

driver.quit()

Read it top to bottom: open a browser, find each field, type into it, click login, then count the products. Every step begins by locating one element.

Advanced — pick locators that survive a redesign

Prefer stable, human-meaningful hooks. By.ID is best when it exists. By.CSS_SELECTOR handles most of the rest. Reach for By.XPATH only when you truly need it.

Grounded in the official Selenium (Python) docs — WebDriver Locators