What are revisions?
In professional screenwriting, revisions indicate which lines have changed between drafts. Productions use revision marks to:- Track script changes during shooting
- Identify new dialogue or scenes
- Coordinate updates across departments (actors, crew, etc.)
Enabling Revision Mode
Toggle Revision Mode
Before you can mark revisions, you need to enable Revision Mode: From the Titlebar (fastest):- Click the pencil icon in the top-right titlebar
- Click the toggle switch to enable Revision Mode
- The button turns colored when active
- Screenplay → Revision Mode (toggle on/off)
Choose Your Revision Color
Inkwell offers 9 industry-standard revision colors:- Blue - 1st revision, marker:
* - Pink - 2nd revision, marker:
** - Yellow - 3rd revision, marker:
*** - Green - 4th revision, marker:
**** - Goldenrod - 5th revision, marker:
***** - Buff - 6th revision, marker:
****** - Salmon - 7th revision, marker:
******* - Cherry - 8th revision, marker:
******** - Tan - 9th revision, marker:
*********
- Click the pencil icon in the titlebar
- Select a revision from the list
- Future marks will use this color
The number of asterisks indicates the revision level. First revision =
*, second = **, and so on. This appears in the right margin when printed.Revision basics
How revisions work
Revisions mark individual lines that have been edited. Marked lines appear with:- Colored highlight behind the text (in editor)
- Colored background matching the revision color
- Asterisks in the right margin (when printed/exported)
*for Blue (1st revision)**for Pink (2nd revision)***for Yellow (3rd revision)- And so on…
When to use revisions
- Production rewrites: Track changes after a script is locked for shooting
- Collaborative editing: Show what changed between drafts
- Agent/producer notes: Highlight implemented feedback
Revisions are optional. Most spec scripts and early drafts don’t need revision tracking. Use revisions when your script enters production or professional review.
Mark lines as revised
1
Enable Revision Mode
Click the pencil icon in the titlebar and toggle Revision Mode ON. Choose your revision color (default is Blue).
2
Edit your script
Make changes to your script. As you type:
- New text is highlighted with the current revision color
- Deleted text leaves an invisible deletion marker
- The margin shows asterisks (
*,**, etc.) indicating revision level
3
Manually mark existing text
To mark text that’s already written:
- Select the lines you want to mark
- Press
Cmd/Ctrl+[or go to Screenplay → Mark Selection Revised - The lines are marked with the current revision color
Automatic vs Manual Marking
Automatic (Revision Mode ON):- All new typing is automatically marked
- Deletions create invisible markers
- No need to manually select and mark
- Select existing text
- Press
Cmd/Ctrl+[ - Useful for marking text written before enabling Revision Mode
What gets marked
Revision marks apply to entire lines:- Scene headings: The entire heading is marked
- Action: The full action paragraph is marked
- Character + Dialogue: Both the character name and their dialogue are marked together
Clear revision marks
Clear selected marks
1
Select revised lines
Highlight the lines whose revision marks you want to remove
2
Clear marks
- Go to Screenplay → Clear Selected Markers
- Or press
Cmd/Ctrl+]
Clear all marks
To remove all revision marks from your entire script:1
Select all
Press
Cmd/Ctrl+A to select the entire script2
Clear marks
Press
Cmd/Ctrl+] or go to Screenplay → Clear Selected MarkersAll revision marks are removed.Revision colors
Inkwell uses 9 industry-standard revision colors in this order:- Blue (#4dabf7) - marker:
* - Pink (#f06292) - marker:
** - Yellow (#ffd43b) - marker:
*** - Green (#51cf66) - marker:
**** - Goldenrod (#fcc419) - marker:
***** - Buff (#e9ecef) - marker:
****** - Salmon (#ff6b6b) - marker:
******* - Cherry (#e03131) - marker:
******** - Tan (#d6936d) - marker:
*********
How production uses colors
In professional production:- White: Original script (no revision marks)
- Blue: First set of changes (e.g., “Blue Revision - Jan 15”)
- Pink: Second set of changes (e.g., “Pink Revision - Jan 22”)
- And so on through subsequent colors
Changing revision colors
1
Open revision picker
Click the pencil icon in the titlebar (top-right)
2
Select a new color
Click any revision in the list (Blue, Pink, Yellow, etc.)
3
Mark new revisions
All new edits and manual marks will use the new color. Previous marks stay unchanged.
- Write your script (White)
- Make first-round edits, mark them as Blue
- Export “Blue Revision” PDF
- Make second-round edits, switch to Pink, mark new changes
- Export “Pink Revision” PDF with both Blue and Pink marks visible
Export revised scripts
Export to PDF with revisions
1
Open Print/Export
- Go to File → Export → PDF
- Or press
Cmd/Ctrl+Pand click Export PDF
2
Enable revision marks
In the export options, check Include Revision Markers
3
Export
Click Export. Your PDF will include:
- Asterisks (
*) in the right margin next to revised lines - Optional: Color-coded marks (if your PDF viewer supports color)
Export to Final Draft (FDX) with revisions
Final Draft preserves full revision data, including colors and dates.1
Export to FDX
Go to File → Export → Final Draft (.fdx)
2
Open in Final Draft
The exported file includes all revision marks and colors. Final Draft users can continue tracking revisions from where you left off.
Fountain format does not support revisions. Exporting to
.fountain strips all revision marks. Use PDF or FDX if you need to preserve revisions.Import scripts with revisions
Import from Final Draft (FDX)
Inkwell can import Final Draft files with existing revision marks.1
Import FDX file
Go to File → Import → Final Draft (.fdx) and select your file
2
Review revisions
Imported revision marks appear in Inkwell with their original colors preserved
3
Continue tracking
You can add new revisions in a different color or clear existing marks
Import from Fountain or PDF
- Fountain: Does not support revisions. Imported Fountain files have no revision marks.
- PDF: Inkwell can import PDF files, but revision marks are not preserved (PDFs are visual-only).
Revision workflow example
Here’s a typical production workflow using revisions:1
Initial script (White)
Write your first draft and export as PDF. This is your “White” script—the baseline.
2
First revision (Blue)
After notes from the director:
- Make changes to specific scenes
- Select the changed lines
- Mark them as revised (Blue)
- Export as “Blue Revision - [Date].pdf”
- Distribute to cast and crew
3
Second revision (Pink)
After actor feedback:
- Make additional changes
- Change revision color to Pink
- Mark the new changes (Blue marks remain from previous revision)
- Export as “Pink Revision - [Date].pdf”
- Distribute updated pages
4
Production shooting
Cast and crew can see:
- Unmarked lines: Original (White) script
- Blue asterisks: Changes from first revision
- Pink asterisks: Changes from second revision
Best practices
Do use revisions for:
- Production scripts: Once a script is locked for shooting
- Collaboration: Showing changes to co-writers or producers
- Rewrite passes: Tracking which scenes changed between drafts
Don’t use revisions for:
- Spec scripts: Agents and contests don’t need revision marks
- Early drafts: Revision tracking adds complexity during creative development
- Personal drafts: If you’re the only one reading it, revisions aren’t necessary
Tips
- Clear marks between major drafts: Before starting a major rewrite, clear all marks and start fresh
- Export before clearing: Always save a PDF with revision marks before removing them
- Use notes for context: Add inline notes explaining why lines changed (e.g.,
[[ Note: Changed per director's request ]]) - Lock the script: Use Screenplay → Lock Script to prevent accidental edits once revisions are finalized
Common revision questions
Can I mark individual words instead of whole lines?
Can I mark individual words instead of whole lines?
No. Industry-standard revision tracking marks entire lines, not individual words. This matches how Final Draft and professional productions handle revisions.
What if I run out of colors?
What if I run out of colors?
After using all 9 colors (Blue through Tan), start over with Blue. Most productions never need more than 3-4 revision colors. If you’re on your 10th revision, consider consolidating changes into a new “White” baseline script.
Can I see revision dates?
Can I see revision dates?
Not in the current version of Inkwell. You can track dates manually by exporting PDFs with date-stamped filenames (e.g., “Blue Revision - Jan 15.pdf”).
Do revisions affect page count?
Do revisions affect page count?
No. Revision marks are visual indicators only—they don’t add pages or change formatting. Your page count remains accurate.
Can I undo a revision mark?
Can I undo a revision mark?
Yes! Immediately after marking lines, press
Cmd/Ctrl+Z to undo. Once you’ve moved on, use Cmd/Ctrl+] to clear marks manually.Try it yourself
Practice exercise:- Write a short scene (10-15 lines)
- “Edit” a few lines by selecting them and pressing
Cmd/Ctrl+[to mark as Blue - Export to PDF and verify the asterisks appear in the right margin
- Change the revision color to Pink
- Mark a few more lines
- Export again and see both Blue and Pink marks
You now understand how to track revisions like a professional production!