How to Test Breadcrumbs on Web (Complete Guide)

Breadcrumbs are a crucial navigation component in Web applications, helping users understand their current location and traverse through the app. However, if not properly tested, breadcrumbs can lead

April 06, 2026 · 3 min read · How-To Guides

Why Breadcrumbs Testing Matters

Breadcrumbs are a crucial navigation component in Web applications, helping users understand their current location and traverse through the app. However, if not properly tested, breadcrumbs can lead to a poor user experience, causing frustration and confusion. Common failures in breadcrumbs include incorrect or missing links, inconsistent navigation, and inaccessible elements. These issues can significantly impact user engagement and conversion rates. For instance, a study found that 61% of users are unlikely to return to a website with a poor navigation experience.

What to Test

To ensure that breadcrumbs function correctly, the following test cases should be considered:

+ Clicking on a breadcrumb link navigates to the correct page

+ Breadcrumbs update correctly when navigating through the app

+ Breadcrumbs are displayed correctly on different screen sizes and devices

+ Breadcrumbs handle 404 errors or broken links correctly

+ Breadcrumbs behave correctly when a user encounters a login or authorization issue

+ Breadcrumbs are not affected by JavaScript errors or other technical issues

+ Breadcrumbs behave correctly when a user navigates to a page with a long URL

+ Breadcrumbs handle special characters or non-standard characters in URLs

+ Breadcrumbs function correctly when a user uses the browser's back and forward buttons

+ Breadcrumbs are accessible via keyboard navigation

+ Breadcrumbs have a clear and consistent ARIA label

+ Breadcrumbs follow WCAG 2.1 AA guidelines for color contrast and font size

Manual Testing Approach

To manually test breadcrumbs, follow these steps:

  1. Test Environment Setup: Ensure that the test environment is set up with the necessary tools, such as a code editor, browser, and testing framework.
  2. Test Case Execution: Execute each test case, starting with happy path scenarios, followed by error scenarios, edge cases, and accessibility considerations.
  3. Test Data Creation: Create test data, such as user accounts, pages, and links, to simulate real-world scenarios.
  4. Test Results Documentation: Document the test results, including any issues or defects found during testing.
  5. Test Case Iteration: Iterate through each test case, refining the test data and test environment as needed.

Automated Testing Approach

To automate breadcrumb testing, consider using tools and frameworks such as:

Example of a Cypress test:


describe('Breadcrumbs', () => {
  it('navigates to correct page', () => {
    cy.visit('/page1')
    cy.get('.breadcrumb-link').eq(0).click()
    cy.url().should('eq', '/home')
  })
})

Example of a Playwright test:


const { test, expect } = require('@playwright/test');

test('breadcrumbs navigate to correct page', async ({ page }) => {
  await page.goto('/page1');
  await page.click('.breadcrumb-link');
  await expect(page).toHaveURL('/home');
});

How SUSA Tests Breadcrumbs Autonomously

SUSA, an autonomous QA platform, tests breadcrumbs using its 10 user personas, including:

SUSA's autonomous testing approach ensures that breadcrumbs are thoroughly tested, including happy path scenarios, error scenarios, edge cases, and accessibility considerations. SUSA's AI-powered engine learns from each test run, adapting to the application's behavior and improving test coverage over time.

Example of a SUSA test report:


### Breadcrumb Test Results

* **Passed:** 9/10 test cases
* **Failed:** 1/10 test cases
* **Issues Found:**
  + Inconsistent breadcrumb navigation on mobile devices
  + Missing ARIA label for breadcrumb links

By using SUSA's autonomous testing approach, developers can ensure that their breadcrumbs are thoroughly tested, reducing the risk of user frustration and improving overall application quality.

Test Your App Autonomously

Upload your APK or URL. SUSA explores like 10 real users — finds bugs, accessibility violations, and security issues. No scripts.

Try SUSA Free