Warning Catalog

All 12 structured warning codes emitted by Paperbase, with messages, fixes, and examples.

Paperbase emits structured warnings when a render is imperfect but still succeeds. Each warning has a machine-readable code, a human_message, an agent_message, a suggested_fix, and a docs_url. A 200 response with warnings is still a rendered PDF — you decide whether to ship it or fix it first.

Warning shape

{
  "code": "PB_TABLE_HEADER_NOT_REPEATING",
  "severity": "warning",
  "human_message": "Table header does not repeat across pages.",
  "agent_message": "Wrap the table header row in <thead>…",
  "suggested_fix": "thead { display: table-header-group; }",
  "docs_url": "https://paperbase.dev/docs/warnings/PB_TABLE_HEADER_NOT_REPEATING",
  "agent_repairable": true
}

All warning codes

Code	Severity	Category
PB_TABLE_HEADER_NOT_REPEATING	warning	rendering
PB_PAGE_BREAK_INSIDE_BLOCK	warning	rendering
PB_WIDOW_ORPHAN	info	rendering
PB_FONT_FALLBACK	warning	asset
PB_ASSET_TIMEOUT	warning	asset
PB_TAILWIND_CLASS_MISSING	warning	rendering
PB_OVERFLOW_CLIPPED	warning	rendering
PB_THEME_INCOMPLETE	warning	design
PB_LOGO_LOW_RESOLUTION	info	design
PB_COLOR_CONTRAST_LOW	warning	design
PB_TYPOGRAPHY_OVERRIDE	info	design
PB_MARKDOWN_HTML_LEAKAGE	info	input

Warning shape

All warning codes

On this page