Schema budget

Bound recursive OpenAPI schema data for predictable content builds.

Large OpenAPI documents can contain recursive or very deeply nested schemas. Astro OpenAPI stores bounded, JSON-safe schema data in the content layer so a single specification cannot expand without limit during a build.

Configure the budget only when the default is not a good fit:

openApiLoader({
  schemaBudget: {
    maxDepth: 8,
    maxArrayItems: 20,
    maxObjectEntries: 60,
    maxNodes: 1200,
  },
});

Option	Controls
`maxDepth`	Maximum nested schema depth
`maxArrayItems`	Maximum items retained from an array schema
`maxObjectEntries`	Maximum properties retained from an object schema
`maxNodes`	Overall node budget for one normalized schema

Increase gradually

Start with the defaults. Increase one limit at a time when a specific API reference needs more detail, then verify the build output and page size.

Last updated Jul 23, 2026