← API reference
CANONICAL TYPE REFERENCE

PreflightRule

The rule that produced a preflight finding

FONT_NOT_EMBEDDED

A font used on a page has no embedded font program, so the press must substitute one and the type will reflow or change shape.

TRIM_BOX_MISSING

The page declares no TrimBox, leaving the finished size undefined.

BLEED_BOX_MISSING

The page declares no BleedBox, so there is no declared area for artwork to run past the trim.

PAGE_BOX_HIERARCHY

The page boxes are not properly nested (ArtBox/TrimBox must sit inside BleedBox, which must sit inside MediaBox).

TAC_OVER_LIMIT

A page's peak total area coverage — the sum of all ink percentages at one point — exceeds the profile's limit, risking set-off and slow drying.

RGB_IN_CMYK_WORKFLOW

RGB source colour is used in a job destined for a CMYK press, so the colours will shift on an uncontrolled late conversion.

IMAGE_RESOLUTION_LOW

A placed image's effective resolution, after the scaling applied on the page, is below the profile's minimum.

HAIRLINE_RULE

A stroke is thinner than the press can reliably hold, so the line may break up or disappear.

STRUCTURAL_ERROR

A page could not be analysed at all — it failed to decode or rasterize — so no other rule could be evaluated for it.

TRANSPARENCY_PRESENT

A page uses live transparency (a blend mode, constant alpha below 1, or a soft mask), which some workflows require to be flattened first.

OVERPRINT_USED

A page sets fill or stroke overprint, so the affected objects mix with what is beneath them instead of knocking it out.

EXCESS_SPOT_COLORS

The document uses more named spot inks than the profile allows, implying more press units than the job was costed for.

OBJECT_OUTSIDE_TRIM

An object's bounding box extends beyond the TrimBox, so part of it will be cut off unless it is intended bleed.

OBJECT_NEAR_TRIM

An object sits inside the trim but within the profile's safety margin, close enough that normal cutting tolerance may clip it.

PDF_X_VERSION_KEY_MISSING

The GTS_PDFXVersion metadata key is absent, so the file makes no PDF/X conformance claim.

PDF_X_OUTPUT_INTENT_INVALID

The file does not carry exactly one output intent with an embedded ICC profile, so the intended print condition is undefined or ambiguous.

PDF_X_FONT_NOT_EMBEDDED

A font is not embedded. Distinct from FONT_NOT_EMBEDDED in that it is raised as a PDF/X conformance breach, which admits no exceptions.

PDF_X_ENCRYPTION_PROHIBITED

The file is encrypted, which PDF/X forbids because a print provider must be able to open and process it unconditionally.

PDF_X_DEVICE_INDEPENDENT_COLOR

Device-independent colour (RGB, ICCBased, or Lab) is used where the declared standard forbids it — notably PDF/X-1a, which is CMYK and spot only.

PDF_X_TRANSPARENCY_PROHIBITED

Live transparency is present under PDF/X-1a or PDF/X-3, which require flattened content.

PDF_X_TRIM_BOX_MISSING

A page lacks both a TrimBox and an ArtBox. PDF/X requires at least one so the finished size is unambiguous.

PDF_X_VERSION_CEILING_EXCEEDED

The PDF header version is newer than the declared standard permits, so the file may use constructs the standard's consumers cannot handle.

PDF_X_TRAPPED_KEY_INVALID

The document info Trapped key is absent or set to Unknown. PDF/X requires an explicit True or False so the provider knows whether trapping has been applied.

PDF_X_PROHIBITED_ACTION

JavaScript or another forbidden action is present. PDF/X files must be inert documents, not interactive ones.

PDF_X_ANNOTATION_IN_TRIM

An annotation rectangle intersects the TrimBox or BleedBox. PDF/X requires annotations to sit entirely outside the printed area.

PDF_X_CLAIMED_CONFORMANCE_FAILED

The content does not meet the standard the file itself declares. Raised only when validating against the file's own claim rather than a fixed profile.

PDF_X_UNKNOWN_DECLARED_STANDARD

GTS_PDFXVersion declares a standard the validator does not recognise, so the claim could not be checked at all.

PDF_X_LAYERS_PROHIBITED

Optional-content groups (layers) are present under PDF/X-1a or PDF/X-3, where the rendered result must not depend on layer visibility.

PDF_X_FILE_ID_MISSING

The trailer has no file /ID, which PDF/X requires so a file can be identified across a workflow.

PDF_X_EMBEDDED_POSTSCRIPT_PROHIBITED

Embedded PostScript — a /Subtype /PS XObject or a PS operator — is present, which PDF/X forbids because its rendering is not defined by the PDF imaging model.

PDF_X_OPI_PROHIBITED

An OPI (Open Prepress Interface) dictionary is present, implying the real image lives outside the file rather than being embedded.

PDF_X_LZW_PROHIBITED

An LZWDecode filter is used, which PDF/X prohibits.

PDF_X_BOX_NESTING

Page-box nesting is invalid under PDF/X: TrimBox/ArtBox must be contained by BleedBox, which must be contained by MediaBox.

PDF_X_TRANSFER_FUNCTION_PROHIBITED

A transfer function, halftone dictionary, or black-generation/UCR function is present. PDF/X forbids these because they re-map tone at output time, outside the provider's control.

PROC_STEP_CUSTOM

A custom, non-standard ISO 19593-1 processing step is used. Advisory: valid, but the step's meaning is not defined by the standard.

PROC_STEP_TYPE_ON_TYPELESS_GROUP

A /GTS_ProcStepsType is set on a group that does not take one. Only the Structural group is typed; White, Varnish, Legend and the rest are single concepts.

PROC_STEP_CUSTOM_MISSING_CLASS_NAME

A custom processing step is named with a single token. ISO 19593-1 requires custom names to be " ", so the missing space makes the name invalid.

PROC_STEP_UNDEFINED_TYPE

A processing-step type is not one of the types ISO 19593-1 defines for its group.

PROC_STEP_UNDEFINED_TYPE_WITH_CLASS_NAME

A processing-step type is not a defined type, but does carry a second class name, so it reads as a deliberate custom type. Advisory.

PROC_STEP_COLORANT_SHARED_WITH_PRINTING

A processing step is painted in a colorant that printing content also uses, so the finishing mark cannot be separated from the artwork.

PROC_STEP_PROCESS_COLORANT

A processing step is painted in a process (device) colour rather than a spot, so it would print as artwork instead of driving a finishing device.

PROC_STEP_RESERVED_COLORANT

A processing step uses a reserved colorant name (All, None, or Registration), which does not identify a real separation.

PROC_STEP_MULTIPLE_COLORANTS

A processing step uses more than one spot colorant, so it does not map to a single finishing plate or tool.

PROC_STEP_TRANSPARENCY

A processing step contains content painted under transparency, which can alter the mark when flattened.

PROC_STEP_IMAGE

A processing step contains a raster image. Finishing marks must be vector so a cutter or plotter can follow the path.

PROC_STEP_NON_STROKE_IN_STROKE_ONLY

A stroke-only step such as a cut or crease line contains a non-stroked object, which a line-following device cannot interpret.

PROC_STEP_ZERO_TINT

A processing step applies its spot colorant at zero tint, producing an invisible mark that will be missed downstream.

PROC_STEP_NOT_OFF_BLEED

Legend or marks content overlaps the product surface instead of sitting off the bleed, so it would print on the finished item.

PROC_STEP_PRINTING_ABOVE_STEP

Printing content is z-ordered above processing-step content and overlaps it, obscuring the finishing mark.

PROC_STEP_KNOCKOUT

A processing-step spot mark is painted with overprint off, so it knocks out the background it sits on instead of sitting over it.

UNKNOWN

The engine reported a rule this build does not recognise — typically a finding from a newer engine version. The finding's severity and message are still present.

View exact SDL
"""The rule that produced a preflight finding"""
enum PreflightRule {
  """
  A font used on a page has no embedded font program, so the press must substitute one and the type will reflow or change shape.
  """
  FONT_NOT_EMBEDDED
  """The page declares no TrimBox, leaving the finished size undefined."""
  TRIM_BOX_MISSING
  """
  The page declares no BleedBox, so there is no declared area for artwork to run past the trim.
  """
  BLEED_BOX_MISSING
  """
  The page boxes are not properly nested (ArtBox/TrimBox must sit inside BleedBox, which must sit inside MediaBox).
  """
  PAGE_BOX_HIERARCHY
  """
  A page's peak total area coverage — the sum of all ink percentages at one point — exceeds the profile's limit, risking set-off and slow drying.
  """
  TAC_OVER_LIMIT
  """
  RGB source colour is used in a job destined for a CMYK press, so the colours will shift on an uncontrolled late conversion.
  """
  RGB_IN_CMYK_WORKFLOW
  """
  A placed image's effective resolution, after the scaling applied on the page, is below the profile's minimum.
  """
  IMAGE_RESOLUTION_LOW
  """
  A stroke is thinner than the press can reliably hold, so the line may break up or disappear.
  """
  HAIRLINE_RULE
  """
  A page could not be analysed at all — it failed to decode or rasterize — so no other rule could be evaluated for it.
  """
  STRUCTURAL_ERROR
  """
  A page uses live transparency (a blend mode, constant alpha below 1, or a soft mask), which some workflows require to be flattened first.
  """
  TRANSPARENCY_PRESENT
  """
  A page sets fill or stroke overprint, so the affected objects mix with what is beneath them instead of knocking it out.
  """
  OVERPRINT_USED
  """
  The document uses more named spot inks than the profile allows, implying more press units than the job was costed for.
  """
  EXCESS_SPOT_COLORS
  """
  An object's bounding box extends beyond the TrimBox, so part of it will be cut off unless it is intended bleed.
  """
  OBJECT_OUTSIDE_TRIM
  """
  An object sits inside the trim but within the profile's safety margin, close enough that normal cutting tolerance may clip it.
  """
  OBJECT_NEAR_TRIM
  """
  The GTS_PDFXVersion metadata key is absent, so the file makes no PDF/X conformance claim.
  """
  PDF_X_VERSION_KEY_MISSING
  """
  The file does not carry exactly one output intent with an embedded ICC profile, so the intended print condition is undefined or ambiguous.
  """
  PDF_X_OUTPUT_INTENT_INVALID
  """
  A font is not embedded. Distinct from FONT_NOT_EMBEDDED in that it is raised as a PDF/X conformance breach, which admits no exceptions.
  """
  PDF_X_FONT_NOT_EMBEDDED
  """
  The file is encrypted, which PDF/X forbids because a print provider must be able to open and process it unconditionally.
  """
  PDF_X_ENCRYPTION_PROHIBITED
  """
  Device-independent colour (RGB, ICCBased, or Lab) is used where the declared standard forbids it — notably PDF/X-1a, which is CMYK and spot only.
  """
  PDF_X_DEVICE_INDEPENDENT_COLOR
  """
  Live transparency is present under PDF/X-1a or PDF/X-3, which require flattened content.
  """
  PDF_X_TRANSPARENCY_PROHIBITED
  """
  A page lacks both a TrimBox and an ArtBox. PDF/X requires at least one so the finished size is unambiguous.
  """
  PDF_X_TRIM_BOX_MISSING
  """
  The PDF header version is newer than the declared standard permits, so the file may use constructs the standard's consumers cannot handle.
  """
  PDF_X_VERSION_CEILING_EXCEEDED
  """
  The document info Trapped key is absent or set to Unknown. PDF/X requires an explicit True or False so the provider knows whether trapping has been applied.
  """
  PDF_X_TRAPPED_KEY_INVALID
  """
  JavaScript or another forbidden action is present. PDF/X files must be inert documents, not interactive ones.
  """
  PDF_X_PROHIBITED_ACTION
  """
  An annotation rectangle intersects the TrimBox or BleedBox. PDF/X requires annotations to sit entirely outside the printed area.
  """
  PDF_X_ANNOTATION_IN_TRIM
  """
  The content does not meet the standard the file itself declares. Raised only when validating against the file's own claim rather than a fixed profile.
  """
  PDF_X_CLAIMED_CONFORMANCE_FAILED
  """
  GTS_PDFXVersion declares a standard the validator does not recognise, so the claim could not be checked at all.
  """
  PDF_X_UNKNOWN_DECLARED_STANDARD
  """
  Optional-content groups (layers) are present under PDF/X-1a or PDF/X-3, where the rendered result must not depend on layer visibility.
  """
  PDF_X_LAYERS_PROHIBITED
  """
  The trailer has no file /ID, which PDF/X requires so a file can be identified across a workflow.
  """
  PDF_X_FILE_ID_MISSING
  """
  Embedded PostScript — a /Subtype /PS XObject or a PS operator — is present, which PDF/X forbids because its rendering is not defined by the PDF imaging model.
  """
  PDF_X_EMBEDDED_POSTSCRIPT_PROHIBITED
  """
  An OPI (Open Prepress Interface) dictionary is present, implying the real image lives outside the file rather than being embedded.
  """
  PDF_X_OPI_PROHIBITED
  """An LZWDecode filter is used, which PDF/X prohibits."""
  PDF_X_LZW_PROHIBITED
  """
  Page-box nesting is invalid under PDF/X: TrimBox/ArtBox must be contained by BleedBox, which must be contained by MediaBox.
  """
  PDF_X_BOX_NESTING
  """
  A transfer function, halftone dictionary, or black-generation/UCR function is present. PDF/X forbids these because they re-map tone at output time, outside the provider's control.
  """
  PDF_X_TRANSFER_FUNCTION_PROHIBITED
  """
  A custom, non-standard ISO 19593-1 processing step is used. Advisory: valid, but the step's meaning is not defined by the standard.
  """
  PROC_STEP_CUSTOM
  """
  A /GTS_ProcStepsType is set on a group that does not take one. Only the Structural group is typed; White, Varnish, Legend and the rest are single concepts.
  """
  PROC_STEP_TYPE_ON_TYPELESS_GROUP
  """
  A custom processing step is named with a single token. ISO 19593-1 requires custom names to be "<class name> <local name>", so the missing space makes the name invalid.
  """
  PROC_STEP_CUSTOM_MISSING_CLASS_NAME
  """
  A processing-step type is not one of the types ISO 19593-1 defines for its group.
  """
  PROC_STEP_UNDEFINED_TYPE
  """
  A processing-step type is not a defined type, but does carry a second class name, so it reads as a deliberate custom type. Advisory.
  """
  PROC_STEP_UNDEFINED_TYPE_WITH_CLASS_NAME
  """
  A processing step is painted in a colorant that printing content also uses, so the finishing mark cannot be separated from the artwork.
  """
  PROC_STEP_COLORANT_SHARED_WITH_PRINTING
  """
  A processing step is painted in a process (device) colour rather than a spot, so it would print as artwork instead of driving a finishing device.
  """
  PROC_STEP_PROCESS_COLORANT
  """
  A processing step uses a reserved colorant name (All, None, or Registration), which does not identify a real separation.
  """
  PROC_STEP_RESERVED_COLORANT
  """
  A processing step uses more than one spot colorant, so it does not map to a single finishing plate or tool.
  """
  PROC_STEP_MULTIPLE_COLORANTS
  """
  A processing step contains content painted under transparency, which can alter the mark when flattened.
  """
  PROC_STEP_TRANSPARENCY
  """
  A processing step contains a raster image. Finishing marks must be vector so a cutter or plotter can follow the path.
  """
  PROC_STEP_IMAGE
  """
  A stroke-only step such as a cut or crease line contains a non-stroked object, which a line-following device cannot interpret.
  """
  PROC_STEP_NON_STROKE_IN_STROKE_ONLY
  """
  A processing step applies its spot colorant at zero tint, producing an invisible mark that will be missed downstream.
  """
  PROC_STEP_ZERO_TINT
  """
  Legend or marks content overlaps the product surface instead of sitting off the bleed, so it would print on the finished item.
  """
  PROC_STEP_NOT_OFF_BLEED
  """
  Printing content is z-ordered above processing-step content and overlaps it, obscuring the finishing mark.
  """
  PROC_STEP_PRINTING_ABOVE_STEP
  """
  A processing-step spot mark is painted with overprint off, so it knocks out the background it sits on instead of sitting over it.
  """
  PROC_STEP_KNOCKOUT
  """
  The engine reported a rule this build does not recognise — typically a finding from a newer engine version. The finding's severity and message are still present.
  """
  UNKNOWN
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.