Articles on: Auto-Highlighting

Auto-Highlighting or Character Names not working correctly

If Auto-Highlight isn't recognizing your character names, it's almost always one of two things: the script isn't formatted to the industry standard, or the PDF has been flattened. Here's how each one works and how to check for it.

The Auto-Highlight feature uses an algorithm that recognizes the industry-standard Character Name and Dialogue formatting. Since Scriptation deals with PDFs and doesn't receive Character / Dialogue metadata from screenwriting programs, the app analyzes the margins of the document and then applies the highlighting.

Standard formatting indents character names close to the middle of the page — they're not centered — and dialogue is immediately below. Some characters will at times have extensions such as O.S. (offscreen), V.O. (voiceover) or CONT'D (when dialogue is interrupted by an action paragraph).

Industry-standard formatting: the character name is indented near the center of the page with dialogue immediately below it

Scriptation will interpret script text formatted this way and highlight characters reliably. However, if the script isn't formatted to the industry standard, errors can occur. For example, while the formatting in the following script appears to be standard and in no way out of the ordinary, it's actually not standard and the character names won't be detected in Scriptation:

A script that looks standard but is formatted non-standardly, so Scriptation won't detect the character names

📝 NOTE: Auto-Highlight isn't set up for manual entry of character names.

If your script is formatted correctly but the character names still aren't being highlighted...

...the PDF might be flattened. A "flattened" PDF is a file where the contents on the PDF are no longer recognizable as individual parts, so the Scriptation algorithm (or any PDF program) isn't going to be able to recognize ANY text in the file.

This often happens with scanned files and with some watermarking programs.

How to tell if a PDF has been flattened

An easy way to test if your file has been flattened is by trying to use the Text Highlight function:

If the Highlight function doesn't recognize any text, then the file has been flattened. You may want to ask your production office if they can distribute their files in a different way.

What's Next

Why didn't my character or scene highlighting transfer?

Text Highlight vs Highlighting with the Marker

How should my script be formatted?

Updated on: 29/05/2026

Was this article helpful?

Thank you!