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.
| Code | Means | Who acts |
|---|---|---|
audio_unreadable, audio_empty, audio_truncated | The file does not decode fully, has no audio, or stops early | You |
audio_sample_rate_low, audio_bit_depth_low, audio_bit_depth_unknown | Below 44.1 kHz or 16-bit, or the depth cannot be read | You |
audio_channels_unsupported | Not mono or stereo | You |
runtime_changed | The item runs longer than quoted: quote again | You |
track_side_missing, side_runtime_exceeded | A cassette track has no side, or a side is too long for the tape | You |
artwork_unreadable, artwork_format_unsupported, artwork_too_many_pixels | The image does not decode, is not PNG, JPEG, TIFF or WebP, or exceeds 200 megapixels | You |
artwork_dimensions_mismatch | Proportions differ from the template's canvas by more than a pixel | You |
artwork_color_cmyk | CMYK artwork: send RGB, ideally sRGB | You |
artwork_resolution_too_low | Below the template's min_ppi at its printed size | You |
artwork_surface_missing | A required surface has no artwork and no default design | You |
artwork_resolution_low | Between min_ppi and target_ppi (300) at its printed size | Staff review |
artwork_template_unapproved | The surface's template awaits a print-and-fit proof | Staff review |
content_mismatch, file_missing | Tapebloom's stored copy is wrong or missing; staff may ask you to upload again | Staff |
quote_required, price_commitment_expired | The order has no quote, or its price commitment has passed: revise with a new quote | You |
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.
| Format | Surfaces (keys for `surfaces`) |
|---|---|
cassette | jcard_outside, label_side_a, label_side_b |
cd_jewel | front_insert, tray_card, disc_face |
cd_jacket | jacket, 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.