Firefox PDF Annotation — Complete Guide

In this tutorial, you'll learn about Firefox PDF Annotation. We cover key concepts, practical examples, and best practices.

Hook

You open a PDF in Firefox and see the text, but the annotation toolbar (draw, highlight, add text) is missing. The PDF viewer loads in read-only mode. You know Firefox has built-in PDF editing since version 105, but the tools are not showing.

The Wrong Way

Disabling Firefox's built-in PDF viewer (pdfjs.enabled in about:config) forces the browser to download the PDF instead of viewing it, which loses annotation capabilities entirely.

# BAD: Disabling the PDF viewer
# about:config → pdfjs.enabled → false

PDF downloads instead of opening in browser
No annotation tools available at all
Must use external PDF editor

You lose the built-in annotation feature completely.

The Right Way

Check PDF.js settings and ensure annotation mode is enabled.

# 1. Check if the PDF viewer is using the built-in PDF.js
# Look at the URL bar when viewing a PDF:
# about:blank or file:///path/to/file.pdf

# 2. Check pdfjs settings in about:config
# Search for: pdfjs

# Key settings to verify:
# pdfjs.enableHighlight — true
# pdfjs.enableAnnotationEditor — true
# pdfjs.enableFormFilling — true (Firefox 106+)

# 3. If annotation tools are still missing, check the PDF:
# Is the PDF a scanned document (image)?
# Image-based PDFs do not support text highlighting — only drawing tools

# 4. Enable the annotation toolbar manually
# When viewing a PDF, look for the floating toolbar on the top-right:
# Text selection → Highlighter → Drawing → Eraser → Signature

# 5. If the toolbar is invisible, toggle it via keyboard
# Ctrl+Shift+A (or Cmd+Shift+A on macOS) to toggle annotation tools

# 6. Reset pdfjs settings
# about:config → Right-click on pdfjs.enableHighlight → Reset
# about:config → Right-click on pdfjs.enableAnnotationEditor → Reset

Annotation toolbar appears after reset
Highlight text: works ✓
Draw on PDF: works ✓

Prevention

• Keep pdfjs.enableAnnotationEditor = true in about:config.
• Use Firefox 105+ for PDF annotation features.
• For scanned PDFs, use OCR first (external tool) before annotating in Firefox.
• Remember that annotations are saved within the PDF file itself (not in the browser).
• Check Firefox release notes — PDF features improve each version.

Common Mistakes with pdf annotation

1. Mixing let bindings with <- bindings in do notation, producing type errors
2. Overlapping type class instances that cause GHC to reject the program with ambiguous dispatch errors
3. Non-exhaustive pattern matches that compile with warnings then crash at runtime

These mistakes appear frequently in real-world FIREFOX code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.

Practice Exercise

Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.

This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.

FAQ

DodaTech — PDF annotations that work in your browser.