diff --git a/packages/web-react/src/components/Header/README.md b/packages/web-react/src/components/Header/README.md
index a5c4c7252d..0284ec350e 100644
--- a/packages/web-react/src/components/Header/README.md
+++ b/packages/web-react/src/components/Header/README.md
@@ -133,9 +133,11 @@ The component implements the [`HTMLElement`][mdn-api-html-element] interface.
### Desktop-Only Actions
-As the name suggests, desktop-only actions are intended to display only on
-desktop screens. There are two slots to use: primary actions (aligned to the
-left in LTR documents) and secondary actions (aligned to the right).
+As the name suggests, desktop-only actions are intended to display on desktop screens only. They generally work as flex
+containers that define vertical alignment and spacing.
+
+There are two slots you can use: primary actions (aligned to left in LTR documents), and secondary actions (aligned to
+right).
👉 It is critical to **make sure all your actions fit the Header on the
desktop breakpoint**. Spirit intentionally does not provide any overflow
@@ -204,14 +206,16 @@ Both links and buttons are supported:
```
-Finally, you can put any custom content inside HeaderNavItem:
+#### Other Content
+
+You can avoid using the [HeaderNav](#navigation) for standalone links. That way, you can combine links and buttons in
+the same container:
```jsx
-
-
- Sign in
-
-
+
+ Marian
+
+
```
##### HeaderNav API
diff --git a/packages/web-react/src/components/Header/demo/HeaderInvertedWithActionsAndDialog.tsx b/packages/web-react/src/components/Header/demo/HeaderInvertedWithActionsAndDialog.tsx
index 47c165d892..fabe455e9e 100644
--- a/packages/web-react/src/components/Header/demo/HeaderInvertedWithActionsAndDialog.tsx
+++ b/packages/web-react/src/components/Header/demo/HeaderInvertedWithActionsAndDialog.tsx
@@ -59,24 +59,18 @@ const HeaderInvertedWithActionsAndDialog = () => {
-
-
-
-
- Marian
-
-
-
-
-
-
+
+
+ Marian
+
+