Writing for Virtual Reality (VR): Formatting 360-Degree Action
The viewer puts on the headset. They can look anywhere. There's no frame, no cuts, no control. How to script action that happens in every direction at once.

Prompt: Dark Mode Technical Sketch, a VR script page with spatial direction indicators showing 360-degree action around the viewer position, compass-like markers, gaze cues annotated, thin white hand-drawn lines, solid black background, high contrast, minimalist, no 3D renders, no neon colors --ar 16:9
The viewer puts on the headset. They're standing in a forest clearing. Behind them, footsteps. They turn—a figure disappears into the trees. In front of them, a cabin. To their left, smoke rises. They look up: a bird circles overhead.
This is VR storytelling. The screen is everywhere. The viewer can look in any direction at any moment. There's no frame to compose, no edit to control attention—just space, and someone inside it.
Writing for VR requires abandoning almost everything you know about traditional screenwriting. The camera doesn't exist. Cuts are jarring. The viewer is both audience and participant. Your script must describe not a sequence of shots but a navigable environment where story happens spatially.
This is a different craft, and it demands a different format.
The Fundamental Shift: No Frame
Traditional screenwriting is built on the frame. You decide what the audience sees; they see exactly that. Close-up, wide shot, pan left—these are your tools of emphasis and control.
VR eliminates the frame. The viewer's head is the camera. They choose where to look. You can invite attention; you cannot force it.
This changes everything:
You can't cut. A cut in VR is disorienting—a teleportation. Used sparingly, it can work. Used constantly, it causes nausea.
You can't hide things. In film, you control what's off-screen. In VR, there is no off-screen. Everything within the environment is visible if the viewer turns around.
You can't guarantee they see the key moment. The climactic action might happen while the viewer is looking the wrong way.
These limitations are also opportunities. VR offers immersion no flat screen can match. The viewer isn't watching a story—they're inside it.
VR isn't a better movie. It's a different medium entirely.
Formatting Conventions for VR Scripts
There's no industry-standard VR script format, but working practices have emerged. Most VR scripts borrow from both screenwriting and video game design, creating a hybrid document.
Common elements:
Environment description (not scene heading). Instead of "INT. LIVING ROOM – DAY," describe the full 360-degree environment: "You stand in a living room. Ahead, a fireplace with dying embers. To your left, a window showing rain. Behind you, a hallway receding into shadow. Above, a chandelier with one bulb flickering."
Viewer position. Specify where the viewer "is" in the space. Are they standing? Seated? Moving? This affects what they can see and how they'll experience events.
Spatial action. Describe actions with directional cues relative to the viewer: "AHEAD – A figure enters through the door. LEFT – A clock chimes. BEHIND – Floorboards creak."
Gaze cues. Indicate what you want the viewer to look at and how you'll draw attention: "A bird calls sharply to the RIGHT. The viewer turns; they see the cabin."
Time-locked events. Some actions happen regardless of where the viewer looks. Others are triggered by viewer gaze. Distinguish these.
A Table: Spatial Direction Conventions
| Direction | Meaning |
|---|---|
| AHEAD / FORWARD | In front of the viewer's default facing |
| BEHIND | Directly behind the viewer |
| LEFT / RIGHT | To the viewer's sides |
| ABOVE | Overhead |
| BELOW | At feet level or beneath |
| PERIPHERAL | In the edges of vision; not the focus |
| AMBIENT | Everywhere; environmental |
These conventions help directors, sound designers, and VR developers understand spatial intent.
Sample VR Script Excerpt
PROJECT: "The Clearing" RUNTIME: 8 minutes FORMAT: VR narrative, seated viewer
ENVIRONMENT 1: FOREST CLEARING – DUSK
You stand at the center of a forest clearing. The light is fading—gold and amber filtering through trees that ring the clearing in all directions. The ground is carpeted with fallen leaves. Ambient birdsong, distant. Air feels cool.
VIEWER POSITION: Seated, eye level approximately 5 feet. Subtle rotation allowed (seated swivel).
0:00–0:15 – ESTABLISHMENT
The viewer is allowed to look around freely. No directed action. Environmental immersion.
AMBIENT: Wind through leaves. Occasional bird call.
0:15–0:30 – GAZE CUE: BEHIND
A twig SNAPS sharply BEHIND the viewer.
GAZE CUE: Sound draws attention BEHIND. When viewer looks:
A FIGURE in a dark coat stands at the tree line—thirty feet away, motionless, watching. Face obscured by shadow.
If viewer does NOT turn, FIGURE remains until 0:45, then disappears.
0:30–0:45 – ESCALATION
AHEAD: The CABIN is now visible—a structure you didn't notice before, somehow. Small, wooden, a single lit window.
LEFT: Smoke rises from somewhere beyond the trees—too much smoke for a campfire.
AMBIENT: Birdsong has stopped. Silence now. Unsettling.
This format communicates spatial storytelling clearly. Each team member knows what happens where and when.
Drawing Attention Without Cuts
If you can't cut, how do you direct attention? VR writers use several techniques:
Audio cues. Sound is the most powerful tool. A sharp sound to the left makes viewers turn left. Spatial audio is essential—if you write it, the sound designer must implement it correctly.
Movement. Motion attracts the eye. A bird taking flight, a door swinging open, a character walking across the space. Place movement where you want attention.
Light. A sudden illumination—a lamp turning on, lightning, a flashlight beam—draws the gaze.
Character address. If a character looks at the viewer or speaks to them, attention follows. "Hey! Over here!" is a valid gaze cue.
Environmental change. Something appearing or disappearing in a particular direction.
You cannot guarantee attention, but you can design for probability. If a loud crash happens to the left, most viewers will look left.

Prompt: Dark Mode Technical Sketch, an overhead view of a VR scene showing viewer position at center with action events marked around the 360-degree space with timing annotations, thin white lines, black background, minimalist, no 3D renders --ar 16:9
Interactive vs. Passive VR
VR storytelling exists on a spectrum:
Fully passive. The viewer observes. They can look around but cannot affect the story. Like an immersive 360 film.
Semi-interactive. Gaze triggers events. Looking at an object might activate it. Limited agency.
Fully interactive. The viewer can move, pick up objects, make choices. Closer to a video game.
Your script must specify where on this spectrum the experience falls. A passive script focuses on environmental storytelling. An interactive script includes branching paths, object interaction logic, and multiple outcomes.
For this article, we focus on passive and semi-interactive VR—where the viewer is audience, not player.
The "Trench Warfare" Section: What Goes Wrong
Failure Mode #1: Writing Flat Screen Shots
The script reads like a traditional screenplay: "Close-up on hand picking up the letter." There are no close-ups in VR. The viewer controls their attention.
How to Fix It: Describe actions spatially. "The hand picks up the letter (AHEAD, at arm's length from viewer). The viewer can lean closer to read."
Failure Mode #2: Critical Action in One Direction
The story's climax happens AHEAD, but the script gives no cue. Half the viewers miss it because they were looking BEHIND.
How to Fix It: Use audio or movement to cue attention. Before the climax, draw all viewers AHEAD with a sound or event.
Failure Mode #3: Too Many Simultaneous Events
Actions happen LEFT, RIGHT, BEHIND, and ABOVE all at once. The viewer feels overwhelmed and misses everything.
How to Fix It: Layer spatially and temporally. Space out events. One direction at a time. Give viewers time to reorient.
Failure Mode #4: Overusing Cuts
The script transitions constantly: new environment, cut, new environment, cut. Viewers feel dizzy.
How to Fix It: Use fewer environments and longer sequences. When cuts are necessary, use fades or narrative transitions ("Three hours later...").
Failure Mode #5: Ignoring the Body
The viewer's position isn't specified. Are they standing? Seated? Can they walk? Ambiguity causes production confusion.
How to Fix It: Specify viewer position and mobility constraints in every environment description.
Case Study: Designing a VR Horror Sequence
Let's design a horror beat step by step:
Goal: Build dread, deliver a jump scare, and make the viewer feel unsafe in every direction.
Environment: A dark attic. Viewer standing. Boxes and covered furniture in all directions. Single light source (a candle AHEAD).
Phase 1: Establishment (0:00–0:30)
Viewer looks around. Nothing threatening. Environmental sounds: creaking, wind, distant traffic. Candle flickers.
Phase 2: Subtle Cues (0:30–1:00)
BEHIND: A soft scraping sound. Viewer turns—nothing visible. Just shadows.
LEFT: A shape moves in peripheral vision—was that a rat?
Candle dims slightly.
Phase 3: Misdirection (1:00–1:20)
AHEAD: A door rattles. Viewer focuses on the door. Tension builds. The door... stops rattling. Nothing happens.
Viewer relaxes.
Phase 4: Delivery (1:20–1:30)
BEHIND: A breath sound—close, intimate, as if someone is standing right behind the viewer.
Viewer turns BEHIND. A FACE is inches away—then DARKNESS.
The sequence uses spatial storytelling to build fear: sounds from multiple directions create paranoia, misdirection relaxes the viewer, and the payoff comes from the direction they just looked away from.

Prompt: Dark Mode Technical Sketch, a VR storyboard frame showing a first-person view with directional annotations marking where action occurs around the viewer, thin white lines, black background, minimalist, no 3D renders --ar 16:9
Writing Dialogue in VR
Dialogue in VR requires spatial awareness:
Character position. Where is the speaking character relative to the viewer? Are they AHEAD? Moving from LEFT to RIGHT? Circling behind?
Direct address. Does the character speak to the viewer? Make eye contact? In VR, this is powerful—and potentially uncomfortable. Use intentionally.
Spatial audio. Dialogue must be spatialized. If the character is to the LEFT, their voice comes from the LEFT. Write this expectation into the script.
Viewer as character. Is the viewer a character in the story? Are they addressed by name? Can they "respond"? Even in passive VR, the viewer's role needs definition.
The Perspective: Presence Over Control
Traditional filmmaking is about control—shaping exactly what the audience experiences. VR is about presence—creating a space the audience inhabits.
This requires letting go. You can't control where they look. You can't guarantee they see the key moment. You can only build an environment so rich and so intentionally designed that wherever they look, the story is there.
In some ways, this is closer to theater than film. The stage is everywhere. Multiple actors might perform simultaneously. The audience member's attention wanders. The playwright creates a world; the audience experiences a version of it.
VR writing is world-building with invitation. You invite the viewer to look left. You hope they do. If they don't, the story still works—just differently.
That's not a limitation. That's the medium's unique power: no two viewers have the same experience. The story becomes personal because it depends on presence, attention, choice. Even in passive VR, the viewer's gaze is a form of agency.
Write for that agency. Respect it. Design around it.
[YOUTUBE VIDEO: A VR director explaining how they developed a narrative script for a 360-degree film, showing the difference between flat-screen thinking and spatial storytelling.]
Further reading:
- For interactive branching narratives, see interactive fiction (Bandersnatch style): formatting a branching script.
- If you're designing immersive physical experiences, see how to script the narrative environment of an escape room.
- The VR/AR Association has resources on immersive storytelling at thevrara.com{:rel="nofollow"}.
Continue reading

How to Script the Narrative Environment of an Escape Room
The players enter a 1940s detective office. A phone rings. They have sixty minutes to find the killer. The room is the story—and scripting it requires a new kind of environmental storytelling.
Read Article
Adapting a Comic Book into a Screenplay: Managing Onomatopoeias and Splash Pages
The page explodes. 'KRAAKOOOM' arcs across the sky in jagged red letters. Now write that as a screenplay. How to transform a medium that controls space into one that controls time.
Read Article
Writing a 30-Second Commercial: The Audio/Video (A/V) Format Explained
Thirty seconds. Approximately 75 words of dialogue. Every image and word must earn its place. Why commercial scripts use a different format—and how to master it.
Read ArticleAbout the Author
The ScreenWeaver Editorial Team is composed of veteran filmmakers, screenwriters, and technologists working to bridge the gap between imagination and production.