Partial Link Text is a Selenium locator strategy used to identify a web link by matching only a part of the visible text of an anchor element. It is especially useful when the complete link text is long, dynamic, or when only a unique portion of the link text is known.
In Selenium WebDriver, Partial Link Text is implemented using the By.partialLinkText() method in Java. It works with HTML <a> elements and searches for links whose visible text contains the specified partial text.
JustAcademy's Selenium training curriculum includes different locator strategies for identifying web elements, including Link Text and Partial Link Text. You can learn more through the JustAcademy's Selenium Training Course and explore the Register for Course Demo option.
Partial Link Text is a Selenium locator used to locate an anchor link when you know only a portion of its visible text.
For example, suppose a webpage contains the following link:
<a href="https://example.com/courses">View All Selenium Courses</a>If the complete text is View All Selenium Courses, Selenium can locate the link using only a unique portion such as Selenium Courses.
driver.findElement(By.partialLinkText("Selenium Courses")).click();Selenium searches the page for an anchor element whose visible text contains the specified partial text.
Partial Link Text is useful when the complete link text is lengthy or when only a stable portion of the text is available.
The basic Java Selenium syntax is:
driver.findElement(By.partialLinkText("partial text"));To click the identified link:
driver.findElement(By.partialLinkText("partial text")).click();To use Partial Link Text with Selenium Java, import the Selenium classes required for WebDriver and locators.
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
public class PartialLinkTextExample {
public static void main(String[] args) {
WebDriver driver = new ChromeDriver();
driver.get("https://example.com");
driver.findElement(By.partialLinkText("Courses")).click();
driver.quit();
}
}
In this example, Selenium searches for a link whose visible text contains Courses.
<a href="/selenium">Learn Selenium Automation Testing</a>The complete visible text is Learn Selenium Automation Testing.
A partial text such as Selenium can be used:
driver.findElement(By.partialLinkText("Selenium")).click();Link Text generally requires the complete visible text of the link, whereas Partial Link Text uses a portion of the visible text.
| Feature | Link Text | Partial Link Text |
|---|---|---|
| Method | By.linkText() | By.partialLinkText() |
| Text required | Complete link text | Part of link text |
| Element type | Anchor link | Anchor link |
| Example | By.linkText("Login to Account") | By.partialLinkText("Login") |
| Useful for long text | Less convenient | More convenient |
<a href="/login">Login to Your Account</a>Using complete Link Text:
driver.findElement(By.linkText("Login to Your Account")).click();The same link can be located using a portion of its text:
driver.findElement(By.partialLinkText("Login")).click();Another possible partial value is:
driver.findElement(By.partialLinkText("Account")).click();The general process is:
Web Page
↓
HTML Anchor Elements
↓
Visible Link Text
↓
Partial Text Provided
↓
Selenium Searches Matching Links
↓
Matching WebElement
↓
Action such as click()
Partial Link Text is designed for links represented by the HTML <a> element.
<a href="/about">About Our Company</a>
<a href="/contact">Contact Us</a>
For the first link:
driver.findElement(By.partialLinkText("About")).click();For the second link:
driver.findElement(By.partialLinkText("Contact")).click();A partial value should preferably identify one specific link.
<a href="/training">Selenium Automation Training</a>
<a href="/java">Core Java Training</a>
A good locator is:
driver.findElement(By.partialLinkText("Selenium Automation")).click();If several links contain the same partial text, Selenium may identify the wrong element because the locator is not sufficiently specific.
<a href="/selenium">Learn Selenium</a>
<a href="/selenium-course">Selenium Course</a>
<a href="/selenium-project">Selenium Project</a>
Using:
driver.findElement(By.partialLinkText("Selenium")).click();may match more than one link.
Generic words such as Click, More, Learn, View, or Read can occur in many links.
<a href="/java">Learn Java</a>
<a href="/selenium">Learn Selenium</a>
<a href="/python">Learn Python</a>
This is less specific:
driver.findElement(By.partialLinkText("Learn")).click();A more specific locator is:
driver.findElement(By.partialLinkText("Selenium")).click();The most common action performed after locating a link is click().
driver.findElement(By.partialLinkText("Login")).click();The statement finds a matching link and clicks it.
You can retrieve the complete visible text of the identified link using getText().
String linkText = driver.findElement(By.partialLinkText("Selenium")).getText();
System.out.println(linkText);
If the actual link text is Learn Selenium Automation, the output can be:
Learn Selenium AutomationYou can verify whether the matching link is displayed.
boolean displayed = driver.findElement(By.partialLinkText("Login")).isDisplayed();
System.out.println(displayed);
You can check whether the located web element is enabled.
boolean enabled = driver.findElement(By.partialLinkText("Continue")).isEnabled();
System.out.println(enabled);
isSelected() is generally used for checkboxes, radio buttons, and selectable elements rather than ordinary links.
boolean selected = driver.findElement(By.partialLinkText("Option")).isSelected();For normal hyperlinks, isSelected() is generally not useful.
<a href="/login">Login to Your Account</a>Selenium code:
driver.findElement(By.partialLinkText("Login")).click();<a href="/register">Create a New Account</a>Automation:
driver.findElement(By.partialLinkText("Create")).click();<a href="/forgot-password">Forgot Your Password?</a>Automation:
driver.findElement(By.partialLinkText("Forgot")).click();<a href="/selenium-course">Selenium Automation Testing Course</a>A partial link locator can be:
driver.findElement(By.partialLinkText("Selenium Automation")).click();<a href="/selenium">Selenium Training</a>
<a href="/java">Java Training</a>
<a href="/python">Python Training</a>
To select the Selenium link:
driver.findElement(By.partialLinkText("Selenium")).click();findElements() can be used to retrieve multiple matching elements.
List<WebElement> links = driver.findElements(By.partialLinkText("Training"));Required import:
import java.util.List;
import org.openqa.selenium.WebElement;
List<WebElement> links = driver.findElements(By.partialLinkText("Training"));
System.out.println("Matching links: " + links.size());
This is useful when validating navigation menus or lists of course links.
List<WebElement> links = driver.findElements(By.partialLinkText("Training"));
for (WebElement link : links) {
System.out.println(link.getText());
}
List<WebElement> links = driver.findElements(By.partialLinkText("Selenium"));
if (!links.isEmpty()) {
System.out.println("Selenium link is present");
} else {
System.out.println("Selenium link is not present");
}
Modern websites may load links dynamically. An explicit wait can be used before interacting with the link.
WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement link = wait.until(
ExpectedConditions.elementToBeClickable(
By.partialLinkText("Login")
)
);
link.click();
import java.time.Duration;
import org.openqa.selenium.By;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;
Suppose a website generates a link whose text contains a changing value.
<a href="/order/12345">View Order 12345</a>If the stable portion is View Order, a partial link locator may be used:
driver.findElement(By.partialLinkText("View Order")).click();However, the locator should be used only when the matching text is sufficiently unique.
<a href="/profile">View Profile - Rahul</a>Instead of depending on the changing username, a stable partial value can be used:
driver.findElement(By.partialLinkText("View Profile")).click();<a href="/course">Enroll in Selenium Automation Course</a>A partial locator can target a stable phrase:
driver.findElement(By.partialLinkText("Enroll in Selenium")).click();Partial Link Text should be written carefully according to the visible link text. Avoid assuming that different capitalization will always produce the desired match.
driver.findElement(By.partialLinkText("Selenium")).click();When locator behavior becomes uncertain, inspect the actual rendered text in browser developer tools.
Visible link text can contain spaces or formatting that makes exact matching difficult. Partial Link Text can sometimes simplify the locator by using a stable portion.
<a href="/course"> Selenium Automation Course </a>Example:
driver.findElement(By.partialLinkText("Selenium Automation")).click();<nav>
<a href="/home">Home</a>
<a href="/courses">All Selenium Courses</a>
<a href="/contact">Contact Us</a>
</nav>
To click the course navigation link:
driver.findElement(By.partialLinkText("Selenium Courses")).click();<a href="/product/100">View Product Details</a>Automation:
driver.findElement(By.partialLinkText("Product Details")).click();<a href="/article/1">Read Latest Technology News</a>Automation:
driver.findElement(By.partialLinkText("Technology News")).click();<a href="/transactions">View Recent Transactions</a>Automation:
driver.findElement(By.partialLinkText("Recent Transactions")).click();<a href="/users">Manage Registered Users</a>Automation:
driver.findElement(By.partialLinkText("Registered Users")).click();<a href="/privacy">Privacy Policy</a>
<a href="/terms">Terms and Conditions</a>
<a href="/support">Customer Support Center</a>
Examples:
driver.findElement(By.partialLinkText("Privacy")).click();
driver.findElement(By.partialLinkText("Support")).click();
<a href="/help">Visit Help Center</a>driver.findElement(By.partialLinkText("Help Center")).click();<a href="https://example.com">Visit Example Website</a>Selenium can locate the link using part of its visible text:
driver.findElement(By.partialLinkText("Example Website")).click();A link may open another tab or window using target="_blank".
<a href="https://example.com" target="_blank">Open Example Website</a>Partial Link Text can still locate the link:
driver.findElement(By.partialLinkText("Example")).click();If a new window opens, window handling must be performed separately.
Consider:
<a href="/course1">Selenium Course</a>
<a href="/course2">Selenium Advanced Course</a>
Using:
driver.findElement(By.partialLinkText("Selenium")).click();may match the first suitable link rather than the link you intended.
In such cases, use a more specific locator.
| Point | Partial Link Text | ID |
|---|---|---|
| Target | Usually links | Any element with an ID |
| Based on | Visible link text | HTML id attribute |
| Syntax | By.partialLinkText() | By.id() |
| Stability | Depends on link text | Usually strong when ID is stable and unique |
The Name locator identifies elements using the HTML name attribute, while Partial Link Text uses visible link text.
driver.findElement(By.name("username"));
driver.findElement(By.partialLinkText("Login"));
Class Name uses the HTML class attribute, whereas Partial Link Text uses the visible text of an anchor.
driver.findElement(By.className("menu-link"));
driver.findElement(By.partialLinkText("Courses"));
CSS Selector can identify links using attributes, classes, IDs, and other CSS patterns.
driver.findElement(By.cssSelector("a[href='/courses']"));Partial Link Text focuses specifically on visible link text.
XPath provides more advanced relationships and text-based expressions.
driver.findElement(By.xpath("//a[contains(text(),'Selenium')]")).click();This can be useful when Partial Link Text is not specific enough or when the element needs to be identified using additional conditions.
For an anchor containing specific text, XPath can provide similar behavior:
driver.findElement(By.xpath("//a[contains(.,'Selenium')]")).click();The XPath approach can also be combined with attributes or other conditions.
| Feature | Partial Link Text | XPath |
|---|---|---|
| Syntax | Simple | More expressive |
| Text matching | Partial visible link text | Can use text functions and relationships |
| Complex conditions | Limited | Supported |
| Anchor-focused | Yes | No |
| Learning difficulty | Easy | Moderate |
<a href="/login">Login to Your Account</a>driver.findElement(By.partialLinkText("Login")).click();<a href="/register">Create Your Free Account</a>driver.findElement(By.partialLinkText("Free Account")).click();<a href="/logout">Logout from Application</a>driver.findElement(By.partialLinkText("Logout")).click();<a href="/dashboard">Go to User Dashboard</a>driver.findElement(By.partialLinkText("User Dashboard")).click();<a href="/profile">View My Profile</a>driver.findElement(By.partialLinkText("My Profile")).click();<a href="/orders">View All Previous Orders</a>driver.findElement(By.partialLinkText("Previous Orders")).click();<a href="/product/101">View Product Details</a>driver.findElement(By.partialLinkText("Product Details")).click();Partial Link Text can be used inside a Page Object Model class.
public class HomePage {
WebDriver driver;
By seleniumCourseLink =
By.partialLinkText("Selenium");
public HomePage(WebDriver driver) {
this.driver = driver;
}
public void openSeleniumCourse() {
driver.findElement(seleniumCourseLink).click();
}
}
public void clickPartialLink(String text) {
driver.findElement(By.partialLinkText(text)).click();
}
Usage:
clickPartialLink("Selenium");public void clickPartialLink(String text) {
WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement link = wait.until(
ExpectedConditions.elementToBeClickable(
By.partialLinkText(text)
)
);
link.click();
}
import org.testng.annotations.Test;
public class LinkTest extends BaseTest {
@Test
public void verifySeleniumLink() {
driver.findElement(
By.partialLinkText("Selenium")
).click();
}
}
WebElement link = driver.findElement(
By.partialLinkText("Selenium")
);
Assert.assertTrue(link.isDisplayed());
If Selenium cannot find a matching link, a NoSuchElementException can occur.
driver.findElement(By.partialLinkText("NonExistingLink")).click();Possible reasons include:
WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement link = wait.until(
ExpectedConditions.presenceOfElementLocated(
By.partialLinkText("Reports")
)
);
link.click();
If the link is located inside an iframe, Selenium must switch into the iframe before locating the link.
driver.switchTo().frame("paymentFrame");
driver.findElement(
By.partialLinkText("Continue")
).click();
driver.switchTo().defaultContent();
For nested frames, Selenium must switch through the appropriate frame hierarchy before locating the link.
driver.switchTo().frame("outerFrame");
driver.switchTo().frame("innerFrame");
driver.findElement(
By.partialLinkText("Continue")
).click();
driver.switchTo().defaultContent();
Partial Link Text does not directly solve Shadow DOM boundary issues. If a link is inside a shadow root, the shadow root must first be accessed using Selenium's Shadow DOM support and then the appropriate element locator can be used within that context.
AJAX-based applications can dynamically add links after the page initially loads. In such cases, explicit waits can help synchronize the test.
WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement link = wait.until(
ExpectedConditions.elementToBeClickable(
By.partialLinkText("Dashboard")
)
);
link.click();
<a href="/result/1">Learn Selenium WebDriver Automation</a>
<a href="/result/2">Learn Java Programming</a>
driver.findElement(By.partialLinkText("Selenium WebDriver")).click();<a href="/page/2">Go to Next Page</a>driver.findElement(By.partialLinkText("Next Page")).click();<a href="/help">Visit the Customer Help Center</a>driver.findElement(By.partialLinkText("Help Center")).click();<a href="/terms">Read Terms and Conditions</a>driver.findElement(By.partialLinkText("Terms")).click();<a href="/privacy">Read Our Privacy Policy</a>driver.findElement(By.partialLinkText("Privacy Policy")).click();Consider:
<a href="/selenium">Selenium Training</a>
<a href="/selenium-advanced">Selenium Advanced Training</a>
This is too generic:
By.partialLinkText("Selenium")A more specific partial text is:
By.partialLinkText("Selenium Advanced")Partial Link Text is intended for anchor links. A button such as:
<button>Login</button>should not be treated as a normal link-text locator. Use another suitable locator such as ID, CSS Selector, or XPath.
If multiple links contain the same partial text, verify the number of matching elements before clicking.
List<WebElement> links =
driver.findElements(By.partialLinkText("View"));
System.out.println(links.size());
If a link text changes on every execution, Partial Link Text may become unreliable.
View Order 1001
View Order 1002
View Order 1003
A stable attribute-based CSS Selector or XPath may be a better option if available.
Avoid partial values such as:
Click
View
More
Learn
Open
These words may occur in many links on the same page.
Choose a portion of the link text that is expected to remain stable.
driver.findElement(
By.partialLinkText("Selenium Automation")
).click();
Prefer a unique partial phrase over a single common word.
By.partialLinkText("Automation Testing Course")is generally more specific than:
By.partialLinkText("Course")Before creating a locator, inspect the HTML structure using browser Developer Tools. Check the actual anchor text, attributes, parent elements, and whether multiple matching links exist.
If a unique and stable ID exists, it may be preferable to relying on visible text.
<a id="selenium-course" href="/selenium">Learn Selenium</a>driver.findElement(By.id("selenium-course")).click();When links appear asynchronously, use an appropriate explicit wait rather than relying on arbitrary sleep statements.
Using fixed delays can slow tests and still fail when application response time changes.
Prefer:
WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement link = wait.until(
ExpectedConditions.elementToBeClickable(
By.partialLinkText("Login")
)
);
Store frequently used Partial Link Text locators inside page classes instead of scattering locator strings throughout test cases.
private By coursesLink =
By.partialLinkText("Selenium Courses");
public void openLoginPage() {
driver.findElement(
By.partialLinkText("Login")
).click();
}
public void openRegistrationPage() {
driver.findElement(
By.partialLinkText("Create Account")
).click();
}
public void openSeleniumCourse() {
driver.findElement(
By.partialLinkText("Selenium Training")
).click();
}
public void openProductDetails() {
driver.findElement(
By.partialLinkText("Product Details")
).click();
}
public void openTransactions() {
driver.findElement(
By.partialLinkText("Transactions")
).click();
}
public void openUserManagement() {
driver.findElement(
By.partialLinkText("User Management")
).click();
}
import java.time.Duration;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;
public class PartialLinkTextDemo {
public static void main(String[] args) {
WebDriver driver = new ChromeDriver();
try {
driver.manage().window().maximize();
driver.get("https://example.com");
WebDriverWait wait =
new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement link = wait.until(
ExpectedConditions.elementToBeClickable(
By.partialLinkText("Selenium")
)
);
System.out.println("Link text: " + link.getText());
link.click();
} finally {
driver.quit();
}
}
}
Partial Link Text is a Selenium locator strategy used to locate an anchor element by matching a portion of its visible link text. In Java, it is implemented using By.partialLinkText().
driver.findElement(By.partialLinkText("Login")).click();Link Text generally identifies a link using its complete visible text, whereas Partial Link Text identifies it using part of its visible text.
Partial Link Text is intended for anchor links. For buttons, use a suitable locator such as ID, Name, Class Name, CSS Selector, or XPath.
If multiple links match the partial text, using findElement() can result in Selenium interacting with the first matching element according to WebDriver's element search behavior. To inspect all matches, use findElements().
Yes, when a stable portion of the link text remains unchanged. For highly dynamic text, an attribute-based CSS Selector or XPath may provide a more stable locator.
Yes. The same By.partialLinkText() locator can be passed to Selenium's expected conditions.
wait.until(
ExpectedConditions.elementToBeClickable(
By.partialLinkText("Login")
)
);
| Locator | Method | Typical Usage |
|---|---|---|
| ID | By.id() | Unique id attribute |
| Name | By.name() | name attribute |
| Class Name | By.className() | class attribute |
| Tag Name | By.tagName() | HTML tag |
| Link Text | By.linkText() | Complete visible link text |
| Partial Link Text | By.partialLinkText() | Part of visible link text |
| CSS Selector | By.cssSelector() | CSS-based identification |
| XPath | By.xpath() | Advanced element identification |
<nav>
<a href="/courses">Explore Selenium Automation Courses</a>
<a href="/demo">Register for Course Demo</a>
</nav>
Automation examples:
driver.findElement(
By.partialLinkText("Selenium Automation")
).click();
driver.findElement(
By.partialLinkText("Course Demo")
).click();
<a href="/account">Manage Your Account Settings</a>driver.findElement(
By.partialLinkText("Account Settings")
).click();
<a href="/help">Visit Our Customer Support Center</a>driver.findElement(
By.partialLinkText("Customer Support")
).click();
<a href="/orders/123">Track Your Order Status</a>driver.findElement(
By.partialLinkText("Order Status")
).click();
<a href="/download/report.pdf">Download Monthly Sales Report</a>driver.findElement(
By.partialLinkText("Sales Report")
).click();
<a href="/docs">Read Selenium Documentation</a>driver.findElement(
By.partialLinkText("Selenium Documentation")
).click();
When a Partial Link Text locator does not work, check the following:
<a> element.| Exception | Possible Cause | Possible Solution |
|---|---|---|
| NoSuchElementException | Link not found | Check text, page, iframe, and timing |
| ElementNotInteractableException | Element cannot be interacted with | Wait or verify visibility |
| ElementClickInterceptedException | Another element blocks the link | Wait, scroll, or handle overlay |
| StaleElementReferenceException | DOM changed after locating element | Locate the element again |
| TimeoutException | Expected condition not satisfied | Review wait condition and locator |
Need to locate a link
↓
Is there a unique stable ID?
↓
Yes → Use ID
↓
No
↓
Is complete link text stable and unique?
↓
Yes → Use Link Text
↓
No
↓
Is a stable unique partial text available?
↓
Yes → Use Partial Link Text
↓
No
↓
Can CSS Selector identify it clearly?
↓
Yes → Use CSS Selector
↓
No
↓
Use XPath
findElements() when you need to check multiple matches.| Requirement | Example |
|---|---|
| Complete link text | By.linkText("Login to Account") |
| Partial link text | By.partialLinkText("Login") |
| Click link | driver.findElement(By.partialLinkText("Login")).click() |
| Get link text | element.getText() |
| Check visibility | element.isDisplayed() |
| Find multiple links | driver.findElements(By.partialLinkText("Course")) |
| Wait for link | ExpectedConditions.elementToBeClickable(By.partialLinkText("Login")) |
Suppose a course website contains the following navigation links:
<a href="/courses">Explore Automation Courses</a>
<a href="/selenium">Learn Selenium Automation</a>
<a href="/demo">Register for Course Demo</a>
<a href="/contact">Contact Training Team</a>
The Selenium script can interact with these links using Partial Link Text:
driver.findElement(
By.partialLinkText("Selenium Automation")
).click();
After returning to the appropriate page:
driver.findElement(
By.partialLinkText("Course Demo")
).click();
Launch Browser
↓
Open Course Website
↓
Locate Selenium Link
↓
Use Partial Link Text
↓
Click Link
↓
Verify Destination Page
↓
Return to Course Page
↓
Locate Demo Link
↓
Click Demo Link
↓
Verify Registration Page
↓
Close Browser
Partial Link Text is a Selenium locator strategy that identifies anchor links using a portion of their visible text. In Java, the primary syntax is By.partialLinkText("text"). It is particularly useful for long link names where a stable and sufficiently unique portion of the text can identify the desired link.
For reliable automation, the selected partial text should be unique, stable, and meaningful. When multiple links match, dynamic content makes the locator unstable, or more complex identification is required, other locators such as CSS Selector or XPath may be more appropriate.
import java.time.Duration;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;
public class FinalPartialLinkTextExample {
public static void main(String[] args) {
WebDriver driver = new ChromeDriver();
try {
driver.manage().window().maximize();
driver.get("https://example.com");
WebDriverWait wait =
new WebDriverWait(driver, Duration.ofSeconds(10));
WebElement courseLink = wait.until(
ExpectedConditions.elementToBeClickable(
By.partialLinkText("Selenium")
)
);
System.out.println(
"Found Link: " + courseLink.getText()
);
courseLink.click();
} finally {
driver.quit();
}
}
}
By.partialLinkText().findElement().findElements().By.partialLinkText()<a>click()findElements() to inspect them.Partial Link Text is a simple and useful Selenium locator for identifying hyperlinks when only a portion of their visible text is known. It is especially convenient for long navigation links, course links, account links, help links, product links, and other anchor elements.
For reliable automation, always choose a meaningful and unique portion of the link text instead of using generic words. When link text is dynamic or multiple elements contain the same phrase, consider using stable attributes, CSS Selectors, or XPath.
To learn more about Selenium automation testing and locator strategies, explore the JustAcademy's Selenium Training Course.
You can also explore the available learning/demo option through the Register for Course Demo link.
