Skip to main content
document.layout is an optional block that tells renderers how to present the document. Everything here is informational — viewers may honour, partially honour, or ignore it.

​
Shape

{
  "document": {
    "layout": {
      "header":    { /* ribbon */ },
      "footer":    { /* ribbon */ },
      "status":    { /* status */ },
      "styles":    [ /* style */ ],
      "templates": [ /* template */ ],
      "guides":    [ /* format */ ],
      "meta":      {}
    }
  }
}

​
ribbon

Repeating header / footer content. 
{
  "cover": false,
  "show":  true,
  "start": 2,
  "omit":  [],
  "text":  { "en": "DRAFT — CONFIDENTIAL" }
}
FieldTypeRequiredDescription
coverboolean✓Show on the cover page.
showboolean✓Visibility toggle.
texttext✓Ribbon text.
startinteger ≥0—First page the ribbon appears on. Default 0.
omitinteger[] unique—Pages to skip.
metameta—Extension.

​
status

Industry revision status. 
{
  "color":   "blue",
  "round":   2,
  "updated": "2026-01-14T10:12:00Z"
}
FieldTypeRequiredValues
colorenum✓white, blue, pink, yellow, green, goldenrod, buff, salmon, cherry.
roundinteger ≥1✓Revision round. Default 1.
updateddatetime✓ISO 8601.

​
style

A reusable presentation-style fragment. 
{ "id": "big-quote", "default": false, "text": "font-size: 18pt; font-weight: 700;" }
FieldTypeRequiredDescription
idslug✓Referenced by element.styles[].
defaultboolean✓Whether renderers should apply automatically.
textstring (0–5000)✓Renderer-specific style payload.
metameta—Extension.

​
template

A longer reusable fragment, size-limited separately.
FieldTypeRequired
idslug✓
defaultboolean✓
textstring (0–20,000)✓
metameta—

​
guides

References to external presentation standards. 
{
  "id":    "wb-final-draft",
  "title": "Warner Bros / Final Draft convention",
  "url":   "https://screenjson.com/tools/screenjson-ui/#formatting-standards",
  "note":  "US Letter, Courier Prime 12pt, 60 lines/page."
}