Core concepts
Repeating content and pagination
Design arrays, tables, and multi-page content for changing document lengths.
Reviewed 2026-08-05 · PDFDesignAPI Engineering
Bind to an array
A repeated component uses an array from the template schema. Child bindings read fields from the current array item.
Supply an empty array rather than an unexpected type when there are no rows, and decide how the template should present that state.
Design for variable length
Use realistic fixtures for one item, a normal list, and a list that spans pages. Include long descriptions and optional values.
Keep totals and summary logic in the application and supply final values explicitly.
Page boundaries
Review how repeated content behaves near the bottom of every supported page size. Avoid relying on a single ideal fixture.
Use staging and a deterministic fixture suite to catch pagination regressions before production promotion.