← All types
In Input object

PreflightIssueInput

Input mirror of PreflightIssue: a single preflight finding

Fields

The rule that raised this finding; also keys value0/value1

Possible values (51)
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 GTS_PDFX output intent with a valid embedded output-class ICC profile. Other intent subtypes do not satisfy this check.

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.

How serious the finding is. ERROR findings are print-blocking and count towards the report's error count.

Possible values (3)
INFO

Advisory only — reports something worth knowing about the file without implying a defect. Never affects the overall status.

WARNING

The file deviates from the profile in a way that is often intentional (a deliberate spot ink, knowing use of transparency) and needs a human to confirm rather than an automatic reject.

ERROR

A defect that will misprint or that breaks the standard being validated against. Forces the report's status to FAIL.

page

IntOptional

1-based page; omit for a document-level finding

Where on the page the finding occurs, in PDF points; omit when the finding is not localised

message

String!Required

Human-readable description of the finding

Advisory remediation; omit when none is offered

value0

Float!Required

Rule-keyed numeric payload (e.g. TAC peak %, effective DPI, hairline pt). Pass 0 when the rule carries no payload.

value1

Float!Required

Rule-keyed numeric payload (e.g. TAC limit %, minimum DPI, minimum pt). Pass 0 when the rule carries no payload.

Referenced by (1)
Exact type SDL
"""Input mirror of PreflightIssue: a single preflight finding"""
input PreflightIssueInput {
  """The rule that raised this finding; also keys `value0`/`value1`"""
  rule: PreflightRule!
  """
  How serious the finding is. ERROR findings are print-blocking and count towards the report's error count.
  """
  severity: PreflightSeverity!
  """1-based page; omit for a document-level finding"""
  page: Int
  """
  Where on the page the finding occurs, in PDF points; omit when the finding is not localised
  """
  boundingBox: PreflightBoundingBoxInput
  """Human-readable description of the finding"""
  message: String!
  """Advisory remediation; omit when none is offered"""
  suggestedFix: String
  """
  Rule-keyed numeric payload (e.g. TAC peak %, effective DPI, hairline pt). Pass 0 when the rule carries no payload.
  """
  value0: Float!
  """
  Rule-keyed numeric payload (e.g. TAC limit %, minimum DPI, minimum pt). Pass 0 when the rule carries no payload.
  """
  value1: Float!
}