Tools of PDF

What Are PDF Layers?

PDF layers — officially called Optional Content Groups (OCGs) in the PDF specification — let you place content into named groups that can be independently shown or hidden. Think of them like the layers in Photoshop or Illustrator, but inside a PDF.

When a PDF has layers, viewers with layer support (Adobe Acrobat, Foxit, some browsers) display a Layers panel. Users can toggle each layer on or off, changing what's visible on the page without changing the underlying file.

What Layers Are Used For

Layers serve several practical purposes:

Multi-language documents: A single PDF contains text in English, French, and Spanish on separate layers. Viewers toggle the language layer they need.

Print vs. screen versions: A "Screen" layer includes interactive elements, colour backgrounds, and hyperlinks. A "Print" layer has black-and-white graphics optimised for printing. One PDF, two presentations.

Technical drawings: An engineering drawing has layers for dimensions, annotations, title blocks, and the base drawing. Engineers can isolate specific information.

Before/after comparisons: Two states of a design on separate layers — turn one off to see the other.

Legal / redacted versions: A public layer shows the redacted document; a restricted layer (accessible only to authorised users in DRM-protected workflows) shows the full text.

Watermarks: A "Draft" watermark lives on its own layer — easy to remove when the document is finalised without touching the rest of the content.

Multilingual forms: Field labels in different languages on different layers.

How PDF Layers Work Technically

Each layer is an Optional Content Group defined in the PDF's document dictionary. Content (text, images, vector graphics) is tagged with a reference to one or more OCGs.

The document can specify:

Default visibility — which layers are on or off when the PDF first opens
Layer intent — View, Design, or All (hints at when to use the layer)
Radio button groups — only one layer in a group can be on at a time (useful for language switching)

Layers work at the page rendering level — hidden layer content is still in the file, just not rendered. This is important for security: hiding a layer does NOT remove the underlying data.

Viewing Layers in a PDF

Not all PDF viewers support layers.

Adobe Acrobat Reader / Pro: Full layer support. Open the Layers panel: View → Show/Hide → Navigation Panes → Layers. Toggle individual layers on/off.

Foxit PDF Reader: Supports layers via the Layers panel.

Chrome (PDF.js): Limited layer support — may show layers panel but not all toggle operations work.

Safari / Preview (Mac): No layer support — renders all layers at their default visibility.

Mobile PDF apps: Partial support; Adobe Acrobat mobile app handles layers, most others don't.

Creating PDF Layers in Adobe Acrobat Pro

Acrobat Pro allows creating and managing layers directly in an existing PDF.

Open the Layers panel: View → Show/Hide → Navigation Panes → Layers

Add a new layer: Options menu (three lines) in the Layers panel → Add Layer → name the layer

Move content to a layer:

Select content on the page with the Edit PDF tool
Right-click → Optional Content Properties → assign to layer

Set layer default visibility: In the Layers panel, right-click a layer → Properties → set Initial State to Visible or Hidden

Lock a layer: Right-click → Properties → check "Restrict changes" options to prevent users from toggling the layer.

Creating PDF Layers in Adobe InDesign

InDesign is the most natural environment for creating layered PDFs because InDesign already uses a layer model.

Create layers in InDesign: Window → Layers → click the "+" icon to add layers. Name each layer clearly.

Place content on layers: Ensure each element is on the correct layer by checking the Layers panel while the object is selected.

Export with layers: File → Export → Adobe PDF → in the PDF export dialog:

Standard: choose Adobe PDF (Interactive) or Adobe PDF (Print)
On the General tab: check "Create Acrobat Layers"

This maps each InDesign layer to a PDF Optional Content Group.

Creating PDF Layers in Adobe Illustrator

Illustrator also maps its layers to PDF OCGs on export.

File → Save As → Adobe PDF → in the PDF dialog:

Check "Create Acrobat Layers from Top-Level Layers"

Each top-level Illustrator layer becomes a PDF layer.

Creating Layered PDFs Programmatically

For developers who need to generate layered PDFs from code:

Python (PyMuPDF/fitz): PyMuPDF supports reading OCG properties but creating OCGs from scratch requires working with the PDF dictionary directly.

Python (reportlab): ReportLab's commercial PLATYPUS system supports OCGs; the open-source version has limited support.

JavaScript (pdf-lib): pdf-lib can read and write OCG dictionaries for more control.

LibreOffice / OpenDocument: LibreOffice Draw can create layered PDFs via its layer system, though support is less complete than InDesign.

Managing Layers in Existing PDFs

Removing Layers

To permanently flatten all layers (merge everything into a single non-layered PDF):

Acrobat Pro: In the Layers panel → Options → Flatten Layers. This merges all visible layer content permanently and removes the layer structure.

Ghostscript:

gs -sDEVICE=pdfwrite -dFlattenLayerContent=true -o output.pdf input.pdf

Extracting a Single Layer

To create a PDF containing only one layer's content:

In Acrobat Pro, hide all layers except the one you want
Print to PDF (File → Print → save as PDF) — only visible content is printed

Changing Layer Names

In Acrobat Pro: Layers panel → double-click a layer name → rename it. Useful when inheriting poorly-named layered PDFs.

Security Considerations with Layers

Because hidden layer content remains in the file, layers are NOT a security tool:

Hidden layers can be revealed by anyone with Acrobat Reader
The raw PDF content stream is accessible with PDF analysis tools
To truly remove content, you must flatten or redact — not just hide

For confidential content, always use proper redaction (Tools → Redact in Acrobat Pro) rather than hiding on a layer.

PDF Layers vs. PDF Portfolios

These are often confused:

PDF Layers (OCGs): Multiple content states within a single PDF page. Toggle visibility to show different content on the same page.

PDF Portfolios: A container PDF that holds multiple separate PDF files (or other files) as a collection. Like a ZIP file presented in PDF format. Not layered content — separate documents.

Summary

PDF layers let you embed multiple content states in a single document — languages, print/screen variants, technical drawing annotations, or conditional watermarks. Create layered PDFs in InDesign or Illustrator by enabling the layer export option, or manage them directly in Acrobat Pro. Remember that hidden layers are still in the file — for true content removal, flatten or redact rather than hiding. Not all PDF viewers support layers, so design with a sensible default visibility state that works for viewers without layer support.

PDF Layers Explained: Optional Content Groups in PDF Documents