01 The Grid

This system defaults to a 12-unit grid: 3 Columns wide by 4 Rows tall. This gives you clean halves, thirds, and quarters. The grid can change (a page might use 3×3 or 4×6), but when it does, the dimensions are declared once at the top of the script (e.g. GRID 3x3). Every shortcode on that page is then read against those declared dimensions, not the default.

Scale-Agnostic by Design

The grid is proportional, not pixel-based. The same shortcodes work identically whether your page is A5, A4, A3, A2, or any custom trim size. Just scale the page; the ratios never change.

The Format [Width × Height @ Col,Row]

Reading the Shortcode

[2x3 @1,2]
Width1 to max cols
default max: 3
Height1 to max rows
default max: 4
@ Col,RowStarting position
(omit if starting @1,1)

Columns run 1→3 left to right. Rows run 1→4 top to bottom. These are the defaults. A non-standard grid must be declared at the top of the script.

DEFAULT GRID (3×4)
COL 1 COL 2 COL 3 ROW 1 ROW 2 ROW 3 ROW 4 1,1 2,1 3,1 1,2 2,2 3,2 1,3 2,3 3,3 1,4 2,4 3,4
← 3 Columns × 4 Rows = 12 Units →

02 Quick Reference Cards

All examples below assume the default 3×4 grid. On a different grid, the same shortcode covers a different proportion of the page.

[3×1]
Full-width strip, spanning all 3 columns and 1 row tall (¼ page). Great for wide establishing shots.
[1×4]
Full-height strip. 1 column wide, all 4 rows tall (⅓ page). Narrow vertical panel.
[3×2]
Exact half page. Full width, half height. The definitive horizontal split.
[3×4]
SPLASH!
Full page splash. One single panel covering the entire page.
03 Scenario A: Big Top, Small Bottom
Col 1
Col 2
Col 3
P1 [3×2 @1,1]
P2
P3
P4
P5
P6
P7

A cinematic establishing shot claims the top half, then six small reaction or detail panels fill the bottom. Great for action reveals or environmental intros.

  • P1 [3×2 @1,1] Large establishing shot, top half
  • P2 [1×1 @1,3] Small panel, bottom-left
  • P3 [1×1 @2,3] Small panel, bottom-center
  • P4 [1×1 @3,3] Small panel, bottom-right
  • P5 [1×1 @1,4] Small panel, lower-left
  • P6 [1×1 @2,4] Small panel, lower-center
  • P7 [1×1 @3,4] Small panel, lower-right

04 Scenario B: Uneven & Off-Beat Layouts

Three essential techniques for non-standard panel arrangements, where tension lives between the beats.

Col 1
Col 2–3
P1
[1×4]
P2 [2×4 @2,1]
B1 The Vertical Split (⅓ vs ⅔ Rule)

With 3 columns, a perfect 50/50 vertical split is impossible. Instead, choose an intentional tension:

  • [1×4] Thin vertical strip (⅓ width)
  • [2×4] Wide vertical block (⅔ width)
Wide Shot [3×1 @1,1]
BIG ACTION [3×2 @1,2]
Wide Shot [3×1 @1,4]
B2 The Cinematic Stack

Bookend a large center action panel with two wide establishing strips (top and bottom) for a widescreen film feel.

  • [3×1 @1,1] Wide shot, top
  • [3×2 @1,2] Big center action
  • [3×1 @1,4] Wide shot, bottom
P1
P2
P3
P4
[2×2 @2,2]
P5
P6
P7
P8
B3 The Offset Block

A large [2×2 @2,2] block anchors the right side, leaving Column 1 and Row 1 open for an irregular "L-shaped" arrangement of small panels around it. Creates visual weight and asymmetry.

05 Cheat Sheet

Use Height 2. A [3×2] panel takes up exactly half the page vertically.

Use Width 1 or Width 2. Columns divide the page into thirds horizontally.

Use Height 1. A [3×1] panel is exactly one quarter of the page height.

Always list Rows 1–4 top to bottom. Row 1 is always the topmost.

Always list Columns 1–3 left to right. Column 1 is always the leftmost.

3 columns means no even vertical split. Choose [1×4] + [2×4] for intentional asymmetry.

All ratios are proportional. A5, A4, A3, A2: same shortcodes, same splits. Scale the page, never the system.

Non-default grid? Declare it once at the top: GRID 3x3. All shortcodes on that page use those dimensions.

06 Shortcode Builder

Set your grid dimensions, then draw panels by clicking and dragging. Or switch to lookup mode to paste a shortcode and see where it lands.

Grid
Cols 3
Rows 4
Panels
Draw your first panel on the grid.
! Disclaimer

This guide was conceived, developed, and authored by Julian Maiz under the banner of Mandatory Pictures.

The shortcode notation system described here, including the grid format, layout scenarios, and naming conventions, was developed by Julian Maiz with the assistance of Claude, a chatbot by Anthropic, which helped structure, illustrate, and build the interactive components of this guide.

This is a personal working system, not an established industry standard. While every effort has been made to ensure originality, some conceptual material may have been influenced by sources encountered during research without full attribution being possible. If you recognise ideas here as originating from your work, please reach out.

A note on origin

The framework in this guide was developed with the assistance of LLM-based chatbot tools, which may have drawn on a wide range of sources during generation. No specific originating source for the shortcode system could be identified or verified. This guide represents a developed, expanded, and credited version of that work.