# wp-bootstrap/wp-bootstrap-navwalker

A custom WordPress nav walker class to fully implement the Twitter Bootstrap 4.0+ navigation style (v3-branch available for Bootstrap 3) in a custom theme using the WordPress built in menu manager.

Repository: https://github.com/wp-bootstrap/wp-bootstrap-navwalker
Canonical: https://ross.abutalabs.com/products/wp-bootstrap-navwalker
Homepage: https://wp-bootstrap.github.io/wp-bootstrap-navwalker/
Language: PHP
License: GPL-3.0
License Family: copyleft
Topics: wp-bootstrap-navwalker, walker, bootstrap, wordpress, nav, navigation, twitter-bootstrap, php, wordpress-theme, custom-theme, menus, icons, hacktoberfest
Last push: 2022-08-08T15:23:04+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 5146, "days_push": 1486, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3322, forks 1846 (observed 2026-08-28T04:07:56.326152+00:00)

## What it is
A custom WordPress nav walker class that formats WordPress menus with the markup and CSS classes needed for Bootstrap 4 dropdown navigation. It is a single PHP utility class included in a theme's functions.php, with a separate branch for Bootstrap 3.

## Use cases
- implement bootstrap 4 navigation menus in a wordpress theme
- make wordpress custom menus render bootstrap dropdowns
- add bootstrap navbar styling to wordpress menu manager
- build a wordpress theme compliant with wordpress.org theme review guidelines
- add icon classes to wordpress nav menu items

## When to choose
- you are building a custom WordPress theme with Bootstrap 4 navigation
- you need wordpress.org theme-review-compliant menu markup
- you want dropdown menus driven by the native WordPress menu manager

## When to avoid
- you use Bootstrap 5, whose markup differs from Bootstrap 4
- you don't want to include Bootstrap CSS/JS yourself, since this class only outputs markup
- you need a full theme or page builder rather than a menu formatting utility

## Facets
- artifact type: library
- maturity: maintenance
- function: ui-components, templating
- domain: web-development, cms, frontend
- platform: php, self-hosted
- tags: wordpress, bootstrap-4, nav-walker, menus, dropdown-navigation, wordpress-theme, web-server

## Member repositories
- wp-bootstrap/wp-bootstrap-navwalker (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:56.326152+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:41:49.830791+00:00, confidence not recorded.
  - readme: https://github.com/wp-bootstrap/wp-bootstrap-navwalker (fetched 2026-08-28T04:07:56.326152+00:00, sha 4f3188ee6815)
  - homepage: https://wp-bootstrap.github.io/wp-bootstrap-navwalker/ (fetched 2026-08-29T09:34:48.750525+00:00, sha 9b67499e0297)
- Data as of 2026-08-30T08:39:29.467469+00:00.