From 1a3fd7ec63bcbdc0c349c240de3c9c741a640518 Mon Sep 17 00:00:00 2001
From: Tony Le <32148504+tfle@users.noreply.github.com>
Date: Wed, 24 Jun 2026 09:37:40 +1000
Subject: [PATCH] fix(layout): allow plugins to target the `header` layout
 position

---
 quartz/plugins/loader/config-loader.ts    | 1 +
 quartz/plugins/loader/types.ts            | 2 +-
 quartz/plugins/quartz-plugins.schema.json | 2 +-
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/quartz/plugins/loader/config-loader.ts b/quartz/plugins/loader/config-loader.ts
index 4480a0ac7..9f502ed19 100644
--- a/quartz/plugins/loader/config-loader.ts
+++ b/quartz/plugins/loader/config-loader.ts
@@ -740,6 +740,7 @@ function buildLayoutForEntries(
       groupOptions?: PluginLayoutDeclaration["groupOptions"]
     }[]
   > = {
+    header: [],
     left: [],
     right: [],
     beforeBody: [],
diff --git a/quartz/plugins/loader/types.ts b/quartz/plugins/loader/types.ts
index 30ed00efc..afa8b1815 100644
--- a/quartz/plugins/loader/types.ts
+++ b/quartz/plugins/loader/types.ts
@@ -8,7 +8,7 @@ import { BuildCtx } from "../../util/ctx"
 
 export type PluginCategory = "transformer" | "filter" | "emitter" | "pageType" | "component"
 
-export type LayoutPosition = "left" | "right" | "beforeBody" | "afterBody"
+export type LayoutPosition = "header" | "left" | "right" | "beforeBody" | "afterBody"
 
 export type LayoutDisplay = "all" | "mobile-only" | "desktop-only"
 
diff --git a/quartz/plugins/quartz-plugins.schema.json b/quartz/plugins/quartz-plugins.schema.json
index aa03786f9..6c716cdb9 100644
--- a/quartz/plugins/quartz-plugins.schema.json
+++ b/quartz/plugins/quartz-plugins.schema.json
@@ -238,7 +238,7 @@
             "properties": {
               "position": {
                 "type": "string",
-                "enum": ["left", "right", "beforeBody", "afterBody", "body"],
+                "enum": ["header", "left", "right", "beforeBody", "afterBody", "body"],
                 "description": "Layout position"
               },
               "priority": {