{
"$schema": "https://opencrs.dev/schema/0.1/index.schema.json",
"opencrs": "0.1",
"publisher": { "id": "your-domain.example", "name": "Your Screens", "contact": "specs@your-domain.example" },
"documents": [
{ "url": "https://your-domain.example/opencrs/screens.json", "network": "main", "visibility": "public" }
]
}Examples
Example files. Start small, or see the full set.
OpenCRS is three small JSON documents. Start from the templates, which are the smallest valid version of each, or read the complete worked example from the specification.
Starter templates
Copy these and replace your-domain.example with your own domain. Each names its JSON Schema, so editors such as VS Code check and suggest fields as you type.
{
"$schema": "https://opencrs.dev/schema/0.1/screens.schema.json",
"opencrs": "0.1",
"publisher": "your-domain.example",
"updated_at": "2026-11-01T09:00:00+11:00",
"expires_at": "2027-02-01T00:00:00+11:00",
"networks": [
{
"id": "main",
"name": "Your Screens",
"formats": [
{
"id": "portrait-1080",
"pixels": [1080, 1920],
"media": {
"static": ["image/jpeg", "image/png"],
"motion": ["video/mp4"],
"slot_s": 10,
"max_bytes": 52428800
}
}
],
"screens": [
{ "id": "SCREEN-001", "format": "portrait-1080" },
{ "id": "SCREEN-002", "format": "portrait-1080" }
]
}
]
}{
"$schema": "https://opencrs.dev/schema/0.1/creative.schema.json",
"opencrs": "0.1",
"campaign": { "id": "your-campaign", "advertiser": "Your Advertiser" },
"files": [
{
"file": "portrait.jpg",
"media_type": "image/jpeg",
"pixels": [1080, 1920],
"targets": ["your-domain.example/main/portrait-1080"]
}
]
}A complete example: Harbourline
The specification’s worked example, at the Full level, with the reports the validator writes for it. Harbourline and Larkspur are fictional.
Open it in the checker{
"opencrs": "0.1",
"publisher": { "id": "harbourline.example", "name": "Harbourline", "contact": "specs@harbourline.example" },
"documents": [
{ "url": "https://harbourline.example/opencrs/retail.screens.json", "network": "retail", "visibility": "public" }
]
}{
"opencrs": "0.1",
"publisher": "harbourline.example",
"updated_at": "2026-10-20T09:00:00+11:00",
"expires_at": "2027-01-20T00:00:00+11:00",
"networks": [
{
"id": "retail",
"name": "Harbourline Retail Screens",
"rules": {
"legibility": { "ratio": 150 },
"restricted_categories": ["IAB7-5"],
"required_elements": [
{ "role": "legal", "when": "offer", "min_cap_height_mm": 12 }
],
"motion": { "max_flash_hz": 3 }
},
"venues": [
{ "id": "harbour-central", "name": "Harbour Central", "venue_type": 205 }
],
"formats": [
{
"id": "portrait-totem-75",
"pixels": [1080, 1920],
"physical_mm": [940, 1670],
"media": {
"static": ["image/jpeg", "image/png"],
"motion": ["video/mp4"],
"slot_s": 10, "fps": 30, "max_bytes": 52428800,
"colour_space": "srgb", "audio": false
},
"safe_area": { "top": 120, "right": 60, "bottom": 160, "left": 60 },
"blocked_regions": [
{ "name": "network-logo", "rect_px": [880, 40, 160, 80] }
]
},
{
"id": "atrium-wrap",
"pixels": [5760, 1080],
"physical_mm": [12000, 2250],
"media": { "static": ["image/png"], "motion": ["video/mp4"], "slot_s": 15, "fps": 25 },
"segments": [
{ "id": "left", "rect_px": [0, 0, 1920, 1080] },
{ "id": "front", "rect_px": [1920, 0, 1920, 1080], "primary": true },
{ "id": "right", "rect_px": [3840, 0, 1920, 1080] }
],
"rules": { "notes": "Keep the main message on the front panel; side panels are seen at an angle." }
}
],
"screens": [
{
"id": "HC-L1-001", "format": "portrait-totem-75", "venue": "harbour-central",
"placement": { "environment": "indoor", "level": "L1", "zone": "food court", "mounted_height_mm": 0, "facing": "N" },
"viewing": { "distance_m": [2, 6], "dwell_s": 4, "approach": "head-on", "light": "indoor" },
"platform_ids": { "cms-a": "frame-4411" }
},
{
"id": "HC-L1-002", "format": "portrait-totem-75", "venue": "harbour-central",
"viewing": { "distance_m": [3, 10], "dwell_s": 3, "approach": "oblique", "light": "indoor" },
"overrides": { "blocked_regions": [ { "name": "column", "rect_px": [0, 1700, 300, 220] } ] },
"platform_ids": { "cms-a": "frame-4412" }
},
{
"id": "HC-ATR-001", "format": "atrium-wrap", "venue": "harbour-central",
"viewing": { "distance_m": [8, 30], "dwell_s": 6, "light": "daylight" },
"platform_ids": { "cms-b": "du-77812" }
}
],
"delivery": { "lead_time_hours": 72, "submit": { "portal": "https://screens.harbourline.example/submit" } }
}
]
}{
"opencrs": "0.1",
"campaign": { "id": "larkspur-lunch-nov", "advertiser": "Larkspur Cafe", "category": "IAB8", "tags": ["offer"] },
"files": [
{
"file": "lunch-portrait.png",
"media_type": "image/png",
"pixels": [1080, 1920],
"targets": ["harbourline.example/retail/portrait-totem-75"],
"variant": { "dimension": "weather", "value": "rain" },
"elements": [
{ "role": "headline", "text": "Lunch specials.", "rect_px": [90, 210, 700, 260], "cap_height_px": 92 },
{ "role": "legal", "text": "Weekdays 11:30 to 2:30", "rect_px": [90, 1640, 520, 40], "cap_height_px": 18 },
{ "role": "logo", "rect_px": [90, 160, 260, 60] }
]
},
{
"file": "lunch-portrait-logo-right.png",
"media_type": "image/png",
"pixels": [1080, 1920],
"targets": ["harbourline.example/retail/screen/HC-L1-001"],
"elements": [
{ "role": "headline", "text": "Lunch specials.", "rect_px": [90, 210, 700, 260], "cap_height_px": 92 },
{ "role": "legal", "text": "Weekdays 11:30 to 2:30", "rect_px": [90, 1640, 520, 40], "cap_height_px": 18 },
{ "role": "logo", "rect_px": [820, 100, 200, 60] }
]
}
]
}[
{
"opencrs": "0.1",
"validator": {
"name": "opencrs",
"version": "0.1"
},
"file": "lunch-portrait.png",
"file_sha256": "4d11af64d6e4c59e7260ebd1501b942fff89164c5481d89992dd14abfebb90a4",
"target": "harbourline.example/retail/portrait-totem-75",
"spec_updated_at": "2026-10-20T09:00:00+11:00",
"checked_at": "2026-10-22T12:00:00+11:00",
"result": "fail",
"checks": [
{
"code": "CRS-LEGIBILITY",
"severity": "warning",
"message": "Legal text is 18 px; 16 px minimum at 2 m, ratio 150. Passes with little margin",
"rect_px": [
90,
1640,
520,
40
],
"element": "legal",
"screens": [
"HC-L1-001"
]
},
{
"code": "CRS-LEGIBILITY",
"severity": "warning",
"message": "Headline text is 92 px; 77 px minimum at 10 m, ratio 150. Passes with little margin",
"rect_px": [
90,
210,
700,
260
],
"element": "headline",
"screens": [
"HC-L1-002"
]
},
{
"code": "CRS-LEGIBILITY",
"severity": "error",
"message": "Legal text is 18 px; 23 px minimum at 3 m, ratio 150",
"rect_px": [
90,
1640,
520,
40
],
"element": "legal",
"screens": [
"HC-L1-002"
]
}
]
},
{
"opencrs": "0.1",
"validator": {
"name": "opencrs",
"version": "0.1"
},
"file": "lunch-portrait-logo-right.png",
"file_sha256": "66e329bd9452fed92dddc05106df8a5ee17dd28faf2c5ac98642ea44dc99e618",
"target": "harbourline.example/retail/screen/HC-L1-001",
"spec_updated_at": "2026-10-20T09:00:00+11:00",
"checked_at": "2026-10-22T12:00:00+11:00",
"result": "fail",
"checks": [
{
"code": "CRS-SAFE-AREA",
"severity": "error",
"message": "Logo extends into the safe-area margin (top 120 px)",
"rect_px": [
820,
100,
200,
60
],
"element": "logo"
},
{
"code": "CRS-BLOCKED-REGION",
"severity": "error",
"message": "Logo overlaps the network-logo area",
"rect_px": [
880,
40,
160,
80
],
"element": "logo"
},
{
"code": "CRS-LEGIBILITY",
"severity": "warning",
"message": "Legal text is 18 px; 16 px minimum at 2 m, ratio 150. Passes with little margin",
"rect_px": [
90,
1640,
520,
40
],
"element": "legal"
}
]
}
]