LintPDF LintPDF

Checks Reference

LintPDF runs 500+ engine checks plus the PDF/X-4 conformance suite (91 checks, ISO 15930-7) across these categories. Each finding in a Report references a Check ID, severity level, and affected page.

Engine mode only. The 500+ checks below only run when preflight_source=engine. Jobs submitted with preflight_source=external import their findings verbatim from PitStop / callas / Acrobat / native payloads — LintPDF does not re-check them. See Preflight Modes for the full matrix.

Programmatic consumers should fetch the full registry from GET /api/v1/check-names (unauthenticated, cache-friendly) — it returns the canonical inspection_id → { name, description } mapping for every shipping check.

Fonts

Check IDDescription
font.not_embeddedFont is referenced but not embedded in the PDF
font.subset_incompleteFont subset is missing required glyphs
font.type3_detectedType 3 font detected (bitmap, not scalable)
font.encoding_mismatchFont encoding does not match declared encoding
font.simulated_bold_italicBold or italic style is simulated, not native

Color Spaces

Check IDDescription
color.rgb_in_cmyk_workflowRGB color space found in CMYK workflow
color.spot_color_usageSpot color detected in document
color.icc_profile_missingOutput intent ICC profile not embedded
color.overprint_conflictOverprint settings may cause unexpected output
color.ink_coverage_exceededTotal area coverage exceeds threshold

Images

Check IDDescription
image.low_resolutionImage resolution below minimum DPI threshold
image.jpeg_artifactsJPEG compression artifacts detected
image.missing_or_corruptImage stream is missing or corrupted
image.alpha_transparencyImage contains alpha channel transparency

Transparency

Check IDDescription
transparency.presentTransparency effects detected in document
transparency.blend_modeNon-standard blend mode in use
transparency.soft_maskSoft mask (gradient transparency) detected

Page Geometry

Check IDDescription
geometry.trim_box_missingTrimBox not defined (required for print)
geometry.bleed_insufficientBleed area smaller than minimum threshold
geometry.page_size_mismatchPage dimensions do not match expected size
geometry.content_outside_trimContent extends beyond TrimBox

Compliance

Check IDDescription
compliance.pdfx4_violationDocument violates PDF/X-4 (ISO 15930-7) requirements
compliance.pdfa_violationDocument violates PDF/A archival requirements
compliance.javascript_presentJavaScript detected (prohibited in PDF/X)
compliance.encryption_presentDocument encryption detected

Barcodes

Check IDDescription
barcode.detectedBarcode pattern detected in page content
barcode.low_dpiBarcode area DPI below minimum threshold
barcode.non_compliant_colorsBarcode uses colors that may not scan correctly
barcode.decode_failedBarcode could not be decoded
barcode.grade_below_thresholdISO 15416 barcode grade below minimum
barcode.quiet_zone_insufficientBarcode quiet zone smaller than required

Dieline / Cutter

Check IDDescription
LPDF_DIE_ZORDERDieline drawn below artwork (D-06) — cutter spot must paint on top of every other layer
LPDF_DIE_KNOCKOUTDieline stroke set to knockout instead of overprint (D-07) — leaves white gaps along cut lines
LPDF_DIE_BLEND_MODEDieline painted with non-Normal blend mode (D-08) — RIP will drop or composite the cutter plate
LPDF_DIE_OPACITY_LOWDieline painted with reduced opacity (D-09) — partial alpha does not survive RIP separation
LPDF_PAGE_BLEED_PAST_DIELINEPage BleedBox extends past the dieline polygon (P-30) — press-side bleed allowance does not fit inside the cutter region
LPDF_TEXT_ON_DIELINE_PATHText region overlaps the dieline cut path (F-32) — glyphs will be physically sliced at the cutter
LPDF_DIE_AS_ARTDieline spot used as a fill (D-15) — cutter will follow the filled region as a closed path
LPDF_DIE_LAYER_CONTENTForeign content on a dieline-named OCG layer (D-04) — artwork on the cutter plate
LPDF_DIE_CONTENT_OUTSIDEContent extends beyond the dieline polygon (D-15) — risks clipping in production

This is a representative sample. The full suite includes 500+ checks. Use the GET /api/v1/rulesets endpoint to see which Checks are included in each Ruleset.