Home Pricing Features Docs Tutorials Blog Changelog Start free trial
All tutorials

Episode 2

How to Import a Screenplay and Break It Down

Import a Final Draft screenplay, merge or keep look-alike location names, tag props and vehicles by hand, run AI auto-tagging on one scene or the whole script, and promote tags to elements.

Loads from YouTube on play

Recorded against The Long Way Home. To build the same project as you watch, download the project files (5 MB).

In this episode

  • 0:00 Introduction
  • 0:27 Importing the screenplay
  • 2:20 Reading the breakdown page
  • 3:12 Tagging by hand
  • 4:18 Letting the AI do the first pass
  • 6:19 Promoting tags to elements
  • 7:08 Summary and next steps

In this episode we bring the screenplay for The Long Way Home into FilmBase and start the breakdown. A breakdown is the list of everything each scene needs: who is in it, and the props, vehicles, animals, costumes and effects the crew has to provide. The schedule and the budget are both built from it. For the wider picture, see the script breakdown software page.

If you haven’t yet, download the project files for The Long Way Home from the series page. The Final Draft file you import is in there.


Step 1: Import the Screenplay

  1. Open the Script tab and the Script breakdown page.
  2. Click Import script. The Import script dialog opens.
  3. Click Select file and choose The Long Way Home.fdx.

FilmBase reads Final Draft files, PDFs, Fountain and plain text. A Final Draft file is the best choice when you have one, because it already knows which line is a scene heading and which is dialogue, so nothing has to be guessed.

The preview lists every scene with its length, and Script title reads The Long Way Home. The tabs count what FilmBase found: Scenes 25, Characters 9 and Locations 15, with 16 6/8 pages on the right.

  1. Under Options, leave Create breakdown strips ticked, so every scene arrives on the stripboard ready to schedule.
  2. Leave Import scene elements ticked as well. It brings in any breakdown tags saved in the file. Ours has none.

Step 2: Check for Duplicate Names

Scripts sometimes name one place or person in two ways, so check the Characters and Locations tabs before you import. Names that look alike are marked Possible duplicate.

  1. Click the Locations tab. CAMPER VAN and CAMPER VAN - MOVING are both flagged.
  2. Tick both rows. Keep the name proposes CAMPER VAN.
  3. Click Merge. The tab now reads Locations 14.

Here we change our mind. The moving scenes need a car rig and the others are shot parked, so we want to keep them apart.

  1. Click Undo merge. The tab reads Locations 15 again.

Merging never changes the script text, and nothing is saved until you import. The two LAKE WENDAWAY cabin names are flagged too; leave them as they are.

  1. Click the Scenes tab, then click Import 25 scenes.

Step 3: Read the Breakdown Page

The page fills, with scene 1 selected. It has three parts.

  • The scene list on the left. Each card shows the scene number, its length in eighths of a page, the location, and whether it is interior or exterior, day or night.
  • The script in the middle, one scene at a time, under a scene header with its page count. FilmBase measures pages with its own layout, so every script is measured the same way.
  • The Scene tags panel on the right, with a card for each breakdown category.

The Cast Members card already lists DOT and TESS, because FilmBase created a character for every speaking role while it imported the script. The Locations card shows where the scene is set, DOT’S GARAGE.


Step 4: Tag by Hand

  1. Click the tag icon in the toolbar (tooltip “Enter tagging mode (highlight text to tag)”). A banner says tagging mode is active.
  2. In the action of scene 1, highlight GARDEN GNOME. The tagging popup opens.
  3. Click Props.

The words are underlined in the category’s color, and a GARDEN GNOME chip appears on the Props card. The gnome is the prop the whole story is about.

After the first tag, FilmBase remembers the category, which makes a run of props much quicker.

  1. Highlight bowling bag. The popup opens with Props already picked. Don’t click anything in it.
  2. Highlight camper van. The bowling bag goes onto Props, and the popup opens again for the camper van.
  3. The camper van under the dust sheet belongs somewhere else, so click Vehicles.

Tags don’t have to use the script’s exact words. The camper van is called Beverly in the story, so that’s the name the whole production will use.

  1. Click the camper van chip on the Vehicles card, type Beverly and press Return.
  2. Click the tag icon again to leave tagging mode.

Step 5: Let the AI Do the First Pass

Tagging every scene by hand takes a while, so FilmBase can read the script for you. FilmBase’s AI runs on your own computer, so it works without an internet connection and nothing is uploaded. You can run it as often as you like.

  1. Select scene 14, the farmers’ market, in the scene list.
  2. Check that the scope next to the wand in the toolbar says Current scene.
  3. Click the wand (tooltip “Run auto-tagging”). The suggestions open in the Auto-Tag suggestions panel, sorted into categories: for the market they include eggs, honey, pies, watermelons, an apple crate, a hay bale, pumpkins, the goose, thunder and rain. If the panel doesn’t open, click the lightbulb.

The first run can take a few seconds while the model loads.

Nothing goes into the breakdown until you accept it.

  1. Click the check on watermelons to accept it. It moves onto the Props card as a tag. Accept GOOSE the same way, and it goes onto the Animals card.
  2. Click the cross on a suggestion that’s wrong to dismiss it. Ours files Milo's under Animals.
  3. If a suggestion has the right words but the wrong category, right-click it, open Change category and pick the right one. The hay bale is Set dressing. Then accept it.
  4. You can also drag a suggestion straight onto a card, such as Thunder onto Sound.

When you’re happy with how it reads, run it for the whole script.

  1. Change the scope to All scenes and click the wand. A progress overlay runs through the script and ends with a count of suggestions across the 25 scenes.

Then go scene by scene and accept or dismiss what it found, which is much faster than starting from a blank page.


Step 6: Promote Tags to Elements

A tag is a note on the script that says this thing is in this scene. An element is the thing itself, something the production has to find, schedule and pay for. Promoting a tag makes one element and links every tag with that name to it, across every scene.

  1. Select scene 1 and right-click the Beverly chip on the Vehicles card. The menu lists Edit tag name, Apply to all occurrences…, Promote to element, Link to existing element…, Unlink from element and Remove tag.
  2. Click Promote to element. A notice confirms the element was created.
  3. Right-click GARDEN GNOME on the Props card and choose Promote to element.
  4. Select scene 14, right-click the GOOSE chip on the Animals card and choose Promote to element.

Promote the things that matter for planning, like the picture car, the hero props, the animals and anything that costs money by the day. Everything else stays as a tag, which still prints on the breakdown sheets, and you can promote it whenever you need to.


The script is in, scene 1 and scene 14 are tagged, and Beverly, the garden gnome and the goose are elements. In the next episode, Elements and the Magic Sheet, we finish the breakdown for the whole script, set the story days, check everything on the Magic Sheet, and give our first element a daily rate.

Common questions

What is a script breakdown?

A script breakdown is the list of everything each scene needs: who is in it, and the props, vehicles, animals, costumes and effects the crew has to provide. The shooting schedule and the budget are both built from it.

What screenplay file formats can FilmBase import?

FilmBase imports Final Draft (.fdx) files, PDFs, Fountain and plain text. A Final Draft file is the best choice when you have one, because it already marks which line is a scene heading and which is dialogue, so nothing has to be guessed.

Does FilmBase's AI tagging upload my script?

No. FilmBase's AI runs on your own computer, so auto-tagging works without an internet connection and nothing is uploaded. Its suggestions only go into the breakdown when you accept them, one at a time.

What is the difference between a tag and an element in FilmBase?

A tag is a note on the script that says a thing is in a scene. An element is the thing itself, something the production has to find, schedule and pay for. Right-click a tag and choose Promote to element, and FilmBase makes one element and links every tag with that name to it, across every scene.

Try it on your own production

FilmBase runs on your own computer, and your projects stay there as files you own.

See pricing