diff --git a/src/partials/header-content.hbs b/src/partials/header-content.hbs
index 93f3b0e0..8f0996dd 100644
--- a/src/partials/header-content.hbs
+++ b/src/partials/header-content.hbs
@@ -6,11 +6,12 @@
{{site.title}}
- {{!-- Pagefind Component UI modal search. pagefind-config points the
- components at the index emitted by `pagefind --site` under
- siteRootPath; the trigger button opens the modal overlay (also
- via the Ctrl/Cmd+K shortcut). --}}
-
+ {{!-- Pagefind Component UI modal search. The trigger opens the modal
+ overlay (also via Ctrl/Cmd+K). bundle-path MUST be absolute/root-
+ relative: the components dynamic-import() pagefind.js relative to
+ pagefind-component-ui.js's URL, so a page-relative "./pagefind/"
+ (siteRootPath on shallow pages) doubles to /pagefind/pagefind/. --}}
+