Skip to content

Header or footer text suppressed

The page number and your text both want the same center slot, so the text is dropped with a warning — the two can't share the position.

What it looks like

Most often you never named the slot: on a one-sided document (report, scrreprt, article, scrartcl, or anything flipped with classoption: oneside) the page number falls back to the center of the footer, and a footer line lands on top of it.

# pandoc.yaml
target: report
footer-text: "A Novel"

The same happens when you put the two together explicitly:

# pandoc.yaml
footer-text: "A Novel"
page-number-position: footer:center

WARN: page-number-position occupies footer:center on recto; footer-text
  suppressed on recto
  See https://keystone.knight-owl.dev/errors/header-footer-suppressed/
WARN: page-number-position occupies footer:center on verso; footer-text
  suppressed on verso
  See https://keystone.knight-owl.dev/errors/header-footer-suppressed/

What it means

A header or footer row has one center slot. When the page number sits there, there's no room for center text in the same row, so Keystone keeps the number and drops the text — once per page side (recto and verso), hence two warnings. Nothing is lost silently; the build continues without that text.

(PDF only.)

Give the number and the text different slots

Move the page number — footer:outer puts it at the right edge of a one-sided page — or move the text, centering it in the header while the number holds the footer. See Running headers & footers.