How to Write a Comic Script
A comic script is a set of instructions for someone who can only read the page. Here's the format, the panel math, and the dialogue limits that keep a script producible.
There Is No Official Format — But There Is a Job
Unlike screenwriting, comics have no industry-standard script format. Full script, plot-first, hybrid, a text file with numbered panels — all of it ships. What every working format has in common is the job it does: it tells the artist exactly what to draw in each panel, in order, and nothing else.
That constraint is the whole craft. Prose can say "she remembered the fire." A panel can't. If it isn't visible in the frame or written in a balloon, it doesn't exist. Every line you write should survive the question: can someone draw this?
The Unit Is the Page, Not the Scene
Write in pages. A page is a fixed container — the reader takes it in as one image before reading it panel by panel, and the page turn is the only cliffhanger device comics have that prose doesn't. Structure your script so the last panel of a right-hand page asks a question the turn answers.
Practical budget: five to seven panels per page is the comfortable range. Three or four panels reads slow and heavy — good for a beat that needs weight. Nine or more reads fast and cramped, which is a deliberate effect, not a default. One panel is a splash: it stops the reader. Spend splashes like money.
What Goes in a Panel Description
Four things, in this order, and usually in two or three sentences:
- Where we are — the location, only when it changes.
- Who's in frame — by name, with their emotional state.
- What's happening — one action, in present tense.
- How we see it — the shot and angle, if it matters.
That last one is where new writers either say nothing or say far too much. "Close on Mara's hands" is direction. Three paragraphs about the lighting on the far wall is a short story nobody will draw. Give the camera a note when the note carries meaning — a low angle to make someone loom, an over-the-shoulder to put the reader in a conversation — and stay silent otherwise.
Write actions as single moments. A panel is a frozen instant, so "Kai draws his sword and runs across the roof and leaps" is three panels pretending to be one. Pick the instant that implies the other two.
Dialogue: Count the Words
Balloons take up art. This is the hardest adjustment for prose writers, and it's arithmetic, not taste:
- ~25 words per balloon is a workable ceiling. Past that the balloon eats the drawing.
- ~50 words per panel across all balloons and captions combined.
- Two or three balloons per panel, maximum. Readers track balloon order by position; four in one frame becomes a puzzle.
- Break long speeches into linked balloons on the same character, or split them across panels so the art can react in between.
Captions are a separate budget — narration, time stamps, internal voice. They're the one place a comic can carry interiority, which makes them easy to overuse. If a caption says what the picture already shows, cut the caption, not the picture.
One more rule that saves whole pages: don't write dialogue that describes the action. "I'm going to open this door now" is a character narrating a drawing the reader is already looking at.
A Script That Machines Can Read Too
If you're generating your art rather than handing pages to an artist, the same discipline pays off twice — a script tight enough for an illustrator is also structured enough to compile. WildComiks's script mode reads a plain-text script with a small set of tags and turns it into panels:
#Alleyway_Night [Crowd: Low] [PANEL: WIDE] [SHOT: ESTABLISHING] Rain sheets off a fire escape. Steam from a grate. [PANEL: SQUARE] [SHOT: CLOSE_UP] [ANGLE: LOW] @Mara (wary, +crowbar) presses flat against the brick. MARA: Tell me you counted them. [PANEL: TALL] [SHOT: OTS] @Kai (grim) watches the mouth of the alley. KAI: I counted them. NARRATOR: He had not counted them.
The pieces, in plain English:
#Location_Namesets the scene and carries forward until you change it.[PANEL: WIDE]starts a new panel and sets its shape — WIDE, TALL, FULL, SQUARE, or SPLASH.[SHOT: ...]and[ANGLE: ...]are the camera: establishing, wide, full, medium, close-up, extreme close-up, cowboy; eye, low, high, bird's-eye, dutch, over-the-shoulder, fisheye, profile. Leave them out and the parser infers a sensible shot from who's in the panel.@Name (emotion, action)puts a character in frame. A part prefixed with+is a prop the character keeps hold of.NAME: line— screenplay-style, all caps — is dialogue. Balloon shape follows the tone: a line tagged furious or ending in an exclamation gets a shout balloon, whisper gets a whisper balloon, andNARRATOR:orCAPTION:becomes a caption box.
Tags you don't use are simply ignored, so you can start with nothing but prose and plain NAME: dialogue and add direction only where you actually care.
Revision: Read It Like a Reader
- Read only the balloons. If the story still tracks, you're over-writing dialogue and under-using art.
- Read only the panel descriptions. If it doesn't track at all, the art is doing nothing and you've written a radio play.
- Check your page turns. Every reveal that lands on a left-hand page has been spoiled by the reader's peripheral vision.
- Count the panels per page. Anything over nine, ask what you can cut. Usually it's a panel of someone walking somewhere.
Write One Page
Don't start with issue one. Write a single page — six panels, one small scene, one turn — and put it through the whole pipeline until it looks like a comic. You'll learn more from one finished page than from forty scripted ones.
WildComiks's free tier is 10 panels a day with no credit card, which is close enough to a page and a half to test a script properly.