Pages · Validation & artwork

Validation and artwork

What validation checks, its reason codes, and the artwork template for every printed surface.

A new or revised order moves to validating. Every file is fully decoded, then checked against its format and, for artwork, its surface's template. The order then moves to awaiting_payment (and is charged), or to needs_attention with findings to fix with a revision. Some findings are reviewed by Tapebloom staff instead: the order waits in validating, uncharged, until they are decided. In test mode reviews are approved at once.

Validation reason codes

Each finding has a stable code, the item, track or surface it concerns, and what was measured and expected. attention_reason and the order.needs_attention event carry the first one you need to fix. Treat a code you do not recognize as needing a person to look.

CodeMeansWho acts
audio_unreadable, audio_empty, audio_truncatedThe file does not decode fully, has no audio, or stops earlyYou
audio_sample_rate_low, audio_bit_depth_low, audio_bit_depth_unknownBelow 44.1 kHz or 16-bit, or the depth cannot be readYou
audio_channels_unsupportedNot mono or stereoYou
runtime_changedThe item runs longer than quoted: quote againYou
track_side_missing, side_runtime_exceededA cassette track has no side, or a side is too long for the tapeYou
artwork_unreadable, artwork_format_unsupported, artwork_too_many_pixelsThe image does not decode, is not PNG, JPEG, TIFF or WebP, or exceeds 200 megapixelsYou
artwork_dimensions_mismatchProportions differ from the template's canvas by more than a pixelYou
artwork_color_cmykCMYK artwork: send RGB, ideally sRGBYou
artwork_resolution_too_lowBelow the template's min_ppi at its printed sizeYou
artwork_surface_missingA required surface has no artwork and no default designYou
artwork_resolution_lowBetween min_ppi and target_ppi (300) at its printed sizeStaff review
artwork_template_unapprovedThe surface's template awaits a print-and-fit proofStaff review
content_mismatch, file_missingTapebloom's stored copy is wrong or missing; staff may ask you to upload againStaff
quote_required, price_commitment_expiredThe order has no quote, or its price commitment has passed: revise with a new quoteYou

Artwork templates

Every printed surface has a versioned template. GET /artwork_templates (optionally ?format=cassette) returns each surface's trim size, bleed, safe area and folds in millimetres, its printable mask, the zone kept for each unit's QR code, and the pixels needed to reach 300 ppi. Send artwork that covers the whole canvas (trim plus bleed) at the same proportions; a larger file is fine. Resolution is measured at the printed size from the decoded pixels; the file's DPI setting is ignored.

FormatSurfaces (keys for `surfaces`)
cassettejcard_outside, label_side_a, label_side_b
cd_jewelfront_insert, tray_card, disc_face
cd_jacketjacket, disc_face

Templates are provisional until a print-and-fit proof on the production stock approves them. While provisional, the geometry may change in a new version; an order keeps the version it was submitted with, and its artwork is reviewed by staff. Disc faces print on a Primera Bravo 4202; paper on an Epson EcoTank.