Document formats, limits, and error messages
This reference lists the supported document formats, filename rules, payload limits, and error messages for the ConvertSite document builder.
Supported formats
Documents are generated in one of three standard paper sizes. Portrait is the default orientation; Landscape swaps the width and height.
Format | Portrait dimensions | Landscape dimensions |
|---|---|---|
A4 | 210mm x 297mm | 297mm x 210mm |
Letter | 8.5in x 11in | 11in x 8.5in |
Legal | 8.5in x 14in | 14in x 8.5in |
Filename rules
Document filenames may contain letters, digits, hyphens, underscores, periods, and spaces. Names are truncated at 200 characters, and a document falls back to the name document when its filename is empty or invalid.
Payload limits and timeouts
Generation fails if a request exceeds these limits or takes too long.
Limit | Value |
|---|---|
PDF generation request body | 16 MB |
WeasyPrint HTML input | 8 MB |
Generation timeout | 60 seconds |
When generation takes longer than 60 seconds, the request fails with the error Document generation timed out.
Error messages
These are the errors a reader can hit when a published document is requested or sent.
document does not exist — the requested document page cannot be found; the generate-document endpoint returns a 404 in this case.
document is not published — the document has not been published.
workspace doesn't have an active subscription — the subscription is inactive; the generate-document endpoint returns a 403 in this case.
When publishing is blocked
Publishing a document can be blocked by any of the following conditions:
The workspace is not approved for publishing.
The subscription is cancelled.
The plan does not include the feature.
There is no active plan.
A trial must be started before publishing.
A missing editor lock.
A recent save failure.
Email attachment failures
Sending a document as an email attachment fails when any of the following is true:
The recipients list is incorrect.
The attached document is missing.
The attached document is not found.
The attached document does not match the selected document.
The attached document's subscription is not active.