diff --git a/.changeset/template-header-fields.md b/.changeset/template-header-fields.md
new file mode 100644
index 0000000..c05751c
--- /dev/null
+++ b/.changeset/template-header-fields.md
@@ -0,0 +1,5 @@
+---
+'@passmint/node': minor
+---
+
+Add the optional `headerFields` slot to `TemplateDesign`, so templates created or updated through the SDK can place small fields in the pass header (top-right, next to the logo).
diff --git a/src/types.ts b/src/types.ts
index 1426806..0e5702d 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -35,6 +35,11 @@ export interface TemplateDesign {
   iconImageKey: string | null
   stripImageKey: string | null
   thumbnailImageKey: string | null
+  /**
+   * Small fields shown top-right of the pass, next to the logo (Apple slot,
+   * max 3). Optional — omit for templates that don't use them.
+   */
+  headerFields?: TemplateField[]
   primaryFields: TemplateField[]
   secondaryFields: TemplateField[]
   auxiliaryFields: TemplateField[]