Summary -

In this topic, we described about the below sections -

In a scenario, when we have long linkText for processing a test and using the same linkText for multiple times triggers complexity. So, selenium supports to use some portion of the linkText to perform further actions. partialLinkText strategy used to locate the element using some portion of the linkText in hyperlinks. There is no standard for uniqueness of the linkText on a web page and multiple elements can have same linkText. So, there is a chance that multiple links may have the same linkText. In this scenario, the first link that matches with the partialLinkText selected for testing. linkTexts are always prefixed with the anchor tag (<a >tag) and can easily findout by using anchor tag.


  • Can only select anchor elements.
  • Useful when testing navigation.


  • We must find the text of the link before using it.


Now, let’s understand the working of partialLinkText locator with the help of a simple example. We will launch chrome and navigate to Here, we will try to locate the "How Search works" link using partialLinkText locator "Search works".

Partial Line Text

On inspecting the above web element, we can see an anchor tag (<a>) has the text "How Search works". Now, I will use the value in partialLinkText locator i.e. "Search works" to open "How Search works" page.

Partial Line Text

Let’s see how the automation of the search look like in Selenium IDE that navigates to "How Search works" page using partialLinkText locator.

Partial Line Text

The java program for the above test is -

// Generated by Selenium IDE 
import org.junit.Test; 
import org.junit.Before; 
import org.junit.After; 
import static org.junit.Assert.*; 
import static;
import static org.hamcrest.core.IsNot.not; 
import org.openqa.selenium.By; 
import org.openqa.selenium.WebDriver; 
import org.openqa.selenium.firefox.FirefoxDriver; 
import org.openqa.selenium.remote.RemoteWebDriver; 
import org.openqa.selenium.remote.DesiredCapabilities; 
import org.openqa.selenium.Dimension; 
import org.openqa.selenium.WebElement; 
import org.openqa.selenium.interactions.Actions; 
import org.openqa.selenium.JavascriptExecutor; 
import org.openqa.selenium.Alert; 
import org.openqa.selenium.Keys; 
import java.util.*; 
public class LocatorsTest {   
    private WebDriver driver;   
    private Map<String, Object> vars;   
    JavascriptExecutor js;   
    public void setUp() {     
        driver = new ChromeDriver();     
        js = (JavascriptExecutor) driver;     
        vars = new HashMap();  
    public void tearDown() {    
    public void locators() {     
        driver.manage().window().setSize(new Dimension(1136, 706));     
        driver.findElement(By.partialLinkText("Search works")).click();   

When you run the java program, Chrome driver launches chrome, redirect to,clicks on the link text "How Search works" to How Search works page. Refer the below image for the output -

Partial Line Text

The above example gives a clear understanding of how partialLinkText locator in Selenium works.