If you're building a web application that needs to display PDF documents directly in the browser without requiring users to download files or open external viewers, PDF.js is one of the most powerful tools available. Developed by Mozilla, PDF.js allows you to render PDF files using HTML5 Canvas and JavaScript. One of the most common and practical ways to integrate a PDF viewer into your site is by embedding it in an iframe. In this guide, we'll walk through a complete PDF.js iframe example, explaining every step so you can implement it confidently in your own projects.
What is PDF.js?
PDF.js is an open-source JavaScript library created and maintained by Mozilla. It enables rendering of PDF documents entirely in the browser using pure JavaScript and the HTML5 Canvas element. Unlike relying on browser plugins such as Adobe Reader, PDF.js works across all modern browsers, including mobile devices. It's widely used in applications like Firefox's built-in PDF viewer, Google Drive's preview functionality, and countless custom web apps. Its lightweight design, extensibility, and lack of plugin dependencies make it a go-to solution for developers who need to display PDF content within a web page.
Why Use an Iframe for PDF Rendering?
An iframe creates a sandboxed environment within your main HTML document. When you embed a PDF.js viewer page inside an iframe, it isolates the PDF's rendering logic, styles, and scripts from your host page. This means cleaner code separation, fewer CSS conflicts, and a more modular architecture. Additionally, Mozilla provides a pre-built viewer interface (viewer.html) that is designed to be used inside an iframe out of the box—no need to write a lot of custom code.

Further benefits of the iframe approach include:
- Security: The PDF content runs in a separate browsing context, limiting potential cross-site scripting risks.
- Simplicity: You can drop in the pre-built viewer.html and pass the PDF URL as a parameter.
- Consistency: The viewer interface (toolbar, page navigation, zoom controls) is already built and tested.
- Responsiveness: You can easily style the iframe's dimensions to fit your layout using CSS.
Setting Up the Project Structure
Before diving into the code, let's organize your project. Download the PDF.js library from the official Mozilla repository. For simplicity, we'll use the pre-built distribution (the build/ folder or the full package from the GitHub releases). A typical project structure might look like this:
| File/Folder | Description |
|---|---|
project/ |
Root directory |
pdfjs/ |
PDF.js library folder (extracted from official distribution) |
index.html |
Main HTML page with the iframe |
documents/sample.pdf |
Sample PDF file to display |
Embedding PDF.js Viewer in an Iframe
The simplest way to embed a PDF is to use the provided viewer.html file included in the PDF.js distribution. Here's a complete PDF.js iframe example:

The main index.html page contains an iframe that loads the viewer with the file parameter pointing to your PDF document:
<iframe src="pdfjs/web/viewer.html?file=documents/sample.pdf" width="100%" height="600px" style="border: none;"></iframe>
This single line of HTML embeds the full PDF viewer with toolbar, navigation controls, and scrolling. Adjust the width and height attributes or use CSS to style it responsively.

Hosting the PDF File
The file parameter in the URL above can accept a relative path or a full URL:
- Relative path:
pdfjs/web/viewer.html?file=./documents/sample.pdf - Absolute URL:
pdfjs/web/viewer.html?file=https://example.com/pdfs/sample.pdf
Be mindful of CORS (Cross-Origin Resource Sharing) restrictions. If the PDF is hosted on a different domain, the server must allow cross-origin requests for PDF.js to fetch and render the file.
Customizing the Viewer
Mozilla's viewer.html supports numerous startup parameters that let you control the initial view:
#page=3— Open on page 3#zoom=150— Set initial zoom to 150%#view=FitH— Fit page to horizontal width#toolbar=0— Hide the toolbar#navpanes=0— Hide the sidebar navigation panel
Example combining parameters:
<iframe src="pdfjs/web/viewer.html?file=documents/sample.pdf#page=2&zoom=125&toolbar=0" width="100%" height="600px" style="border: none;"></iframe>
Building a Custom PDF.js Viewer Without the Default UI
If you want full control over the appearance and behavior, you can build your own viewer component and embed it in an iframe or directly in the page. Here's a minimal example that renders a specific page onto a canvas:
You would create a custom HTML file (e.g., my-viewer.html) that loads the PDF.js library and renders pages programmatically. Then embed it via iframe:
<iframe src="my-viewer.html?file=documents/sample.pdf" width="100%" height="800px" style="border: none;"></iframe>
This approach gives you pixel-perfect control at the cost of more development effort.
Common Issues and Troubleshooting
When working with PDF.js in iframes, developers frequently encounter a few gotchas:
- WASM loading errors: PDF.js uses WebAssembly for faster parsing. Ensure your server serves
.wasmfiles with the correct MIME type (application/wasm). - CORS issues: If the PDF is on another domain, the server must return proper
Access-Control-Allow-Originheaders. - Path errors: Relative paths to PDFs depend on the viewer's location. Always test with absolute URLs first.
- Mobile viewport scaling: Add a proper
<meta name="viewport">tag so the iframe scales correctly on smaller screens.
Performance Considerations
For large PDF files (hundreds of pages), rendering the entire document at once can be slow. Use the disableAutoFetch and disableStream options to lazy-load pages as the user scrolls. Consider server-side page range limiting for very large documents. Always test with real-world file sizes your users will encounter, not just small sample PDFs.
The PDF.js iframe approach strikes an excellent balance between ease of implementation and a fully-featured viewer. Whether you choose the pre-built viewer.html for quick integration or build a custom solution for design control, this library provides a reliable, plugin-free way to display PDF content in any modern web application.






















