diff --git a/docs/components/navs.md b/docs/components/navs.md
index 3b4b697a6a..fed519e8e5 100644
--- a/docs/components/navs.md
+++ b/docs/components/navs.md
@@ -12,15 +12,9 @@ Navigation available in Bootstrap share general markup and styles, from the base
* Will be replaced with the ToC, excluding the "Contents" header
{:toc}
-## Regarding accessibility
+## Base nav
-If you are using navs to provide a navigation bar, be sure to add a `role="navigation"` to the most logical parent container of the `
`, or wrap a `` element around the whole navigation. Do not add the role to the `` itself, as this would prevent it from being announced as an actual list by assistive technologies.
-
-## Examples
-
-### Base nav
-
-Roll your own navigation style by extending the base `.nav` component. All Bootstrap's nav components are built on top of this by specifying additional styles. Includes styles for the disabled state, but **not the active state**.
+The base `.nav` component is built with flexbox and provide a strong foundation for building all types of navigation components. It includes some style overrides (for working with lists), some link padding for larger hit areas, and basic disabled styling. No active states are included in the base nav.
{% example html %}
@@ -39,7 +33,7 @@ Roll your own navigation style by extending the base `.nav` component. All Boots
{% endexample %}
-Classes are used throughout, so your markup can be super flexible. Use ``s like above, or roll your own with say a `` element. The change in nav item display below **is intentional** as ``s have a different default `display` than regular `` elements.
+Classes are used throughout, so your markup can be super flexible. Use ``s like above, or roll your own with say a `` element. Because the `.nav` uses `display: flex`, the nav links behave the same as nav items would, but without the extra markup.
{% example html %}
@@ -50,23 +44,18 @@ Classes are used throughout, so your markup can be super flexible. Use `
{% endexample %}
-### Inline
+## Available styles
-Space out nav links in a horizontal band with `.nav-inline`. Longer series of links will wrap to a new line.
+Change the style of `.nav`s component with modifiers and utilities. Mix and match as needed, or build your own.
+
+### Horizontal alignment
+
+Change the horizontal alignment of your nav with [flexbox utilities]({{ site.baseurl }}/layout/grid/#horizontal-alignment). By default, navs are left-aligned, but you can easily change them to center or right aligned.
+
+Centered with `.justify-content-center`:
{% example html %}
-
- Active
- Link
- Link
- Disabled
-
-{% endexample %}
-
-The same works for a navigation built with lists.
-
-{% example html %}
-
+
Active
@@ -82,6 +71,57 @@ The same works for a navigation built with lists.
{% endexample %}
+Right-aligned with `.justify-content-end`:
+
+{% example html %}
+
+
+ Active
+
+
+ Link
+
+
+ Link
+
+
+ Disabled
+
+
+{% endexample %}
+
+### Vertical
+
+Stack your navigation by changing the flex item direction with the `.flex-column` utility. Need to stack them on some viewports but not others? Use the responsive versions (e.g., `.flex-sm-column`).
+
+{% example html %}
+
+{% endexample %}
+
+As always, vertical navigation is possible without ``s, too.
+
+{% example html %}
+
+ Active
+ Link
+ Link
+ Disabled
+
+{% endexample %}
+
### Tabs
Takes the basic nav from above and adds the `.nav-tabs` class to generate a tabbed interface. Use them to create tabbable regions with our [tab JavaScript plugin](#javascript-behavior).
@@ -124,17 +164,17 @@ Take that same HTML, but use `.nav-pills` instead:
{% endexample %}
-### Stacked pills
+### Fill and justify
-Add `.nav-stacked` to the `.nav.nav-pills` to stack them vertically. Each `.nav-link` becomes block-level, allowing for larger hit areas via mouse or tap.
+Force your `.nav`'s contents to extend the full available width one of two modifier classes. To proportionately fill all available space with your `.nav-item`s, use `.nav-fill`. Notice that all horizontal space is occupied, but not every nav item has the same width.
{% example html %}
-
+
{% endexample %}
-As always, stacked pills are possible without ``s.
+For equal-width elements, use `.nav-justified`. All horizontal space will be occupied by nav links, but unlike the `.nav-fill` above, every nav item will be the same width.
{% example html %}
-
- Active
- Link
- Link
- Disabled
+
+{% endexample %}
+
+## Working with flex utilities
+
+If you need responsive nav variations, consider using a series of [flex utilities](). While more verbose, these utilities offer greater customization across responsive breakpoints. In the example below, our nav will be stacked on the lowest breakpoint, then adapt to a horizontal layout that fills the available width starting from the small breakpoint.
+
+{% example html %}
+
+ Active
+ Link
+ Link
+ Disabled
{% endexample %}
+## Regarding accessibility
+
+If you're using navs to provide a navigation bar, be sure to add a `role="navigation"` to the most logical parent container of the ``, or wrap a `` element around the whole navigation. Do not add the role to the `` itself, as this would prevent it from being announced as an actual list by assistive technologies.
+
## Using dropdowns
Add dropdown menus with a little extra HTML and the [dropdowns JavaScript plugin]({{ site.baseurl }}/components/dropdowns/#usage).
@@ -212,88 +277,6 @@ Add dropdown menus with a little extra HTML and the [dropdowns JavaScript plugin
{% endexample %}
-## Justified nav
-
-Create equal-width links in a navigation component by adding `.nav-justified` to a `.nav` component. This works with the inline, tab, and pill variants.
-
-Using the inline nav:
-
-{% example html %}
-
-{% endexample %}
-
-You can also use it on tabs:
-
-{% example html %}
-
-{% endexample %}
-
-And pills, too:
-
-{% example html %}
-
-{% endexample %}
-
-## Centered nav
-
-Using our [flexbox utilities]({{ site.baseurl }}/layout/grid/#horizontal-alignment), you can also customize your navigation components to change the alignment of nav items. For example, here are center aligned links on the inline nav component.
-
-{% example html %}
-
-{% endexample %}
-
## JavaScript behavior
Use the tab JavaScript plugin—include it individually or through the compiled `bootstrap.js` file—to extend our navigational tabs and pills to create tabbable panes of local content, even via dropdown menus.