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.

Index

opencrs.json

Says which screens.json files are yours. A validator only trusts a screens.json that the publisher’s own index lists.

Written by
The publisher: a media owner or landlord
Lives
At https://your-domain/.well-known/opencrs.json
Download
{
  "$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" }
  ]
}

Screen specs

screens.json

Describes a type of screen once, as a format, and lists the screens that use it. This is the Core level: pixels and accepted media. Add safe areas, viewing distances and rules when you have them.

Written by
The publisher
Lives
At the address the index lists
Download
{
  "$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" }
      ]
    }
  ]
}

Creative manifest

creative.json

Says which file is meant for which format or screen, so a validator knows what to check it against.

Written by
The agency or creative tool
Lives
Delivered with the creative files
Download
{
  "$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

Index

opencrs.json

Harbourline’s index, listing its retail network’s specs.

Download
{
  "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" }
  ]
}

Screen specs

retail.screens.json

One network, one shopping centre, two formats and three screens. One screen, HC-L1-002, has a column in front of its corner, so it adds a blocked area to the shared format.

Download
{
  "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" } }
    }
  ]
}

Creative manifest

creative.json

Two files for Larkspur’s lunch campaign: one for the whole portrait-totem format, and one for a single screen.

Download
{
  "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] }
      ]
    }
  ]
}

Validation reports

reports.json

What the reference validator writes when it checks the two files against the specs: the result for each file and screen, and each finding with its code.

Download
[
  {
    "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"
      }
    ]
  }
]