Disclosure: MantraBrain is associated with MatrixAddons, the maker of Document Engine. We explain where the free plugin works well and where the paid add-on is needed.
Need to show a PDF on a WordPress page? The right method depends on whether you’re publishing one menu or managing a whole collection of forms, reports and guides. Here are four practical approaches, with the trade-offs explained.
Method 1: Link directly to a PDF
Upload the PDF to Media → Add New Media File, copy its file URL and add a text or button link to a page. This is fast and works for occasional downloads. The downside is that visitors must leave the page or open another tab, and a long list of links is difficult to browse.
Method 2: Use the WordPress File block
In the block editor, add a File block, choose a PDF and configure the download button. Depending on your WordPress setup, the block may also show an embedded PDF preview. This is a sensible choice for a single PDF on a landing page.
Method 3: Embed a PDF with a dedicated viewer
A PDF viewer provides navigation controls and a more consistent reading experience. Check whether the viewer uses third-party services, how it behaves on mobile and whether text is selectable. For public documents, a lightweight viewer may be all you need.
Method 4: Use a document library with built-in PDF previews
When you have multiple PDFs, consider Document Engine. The free plugin adds a document content type, a searchable library with table/grid/folder layouts and a PDF.js viewer hosted on your own website. Create documents under Documents → Add New, then place the Document Library block on a page. Visitors can filter documents and preview PDFs rather than hunting through individual links.
Which method should you choose?
| Situation | Suggested approach |
|---|---|
| One brochure or menu | Direct link or File block |
| One long PDF to read on-page | Dedicated viewer |
| Many public reports or forms | Document library |
| Private policies and controlled sharing | Document library with Pro access controls |
How to display a PDF using Document Engine
- Install and activate Document Engine.
- Create a document and attach your PDF.
- Publish it and open its document page to test the viewer.
- For a collection, create a page with the Document Library block.
- Choose the layout and enable the filters your audience needs.
When Document Engine Pro is worth considering
Public PDF viewing is available in the free version. Pro is designed for situations requiring role-based restrictions, protected storage, expiring links, audit logs, stamped copies or secure view-only options. Remember that hiding download or print controls alone is not a substitute for access control.
Accessibility and performance tips
Use meaningful link text, provide a descriptive page title, compress oversized PDFs and test keyboard navigation. A viewer does not automatically make a scanned or untagged PDF accessible; prepare accessible source documents when possible.
Frequently asked questions
Can I display a PDF without a plugin?
Yes. Use a direct link or the WordPress File block.
Can visitors search within a displayed PDF?
Document Engine’s built-in viewer includes search within the opened PDF. Library-wide file-content search is a Pro feature.
Do I need Pro for a public PDF library?
No. The free version includes libraries, filters and PDF previews.
Method 4: Exact shortcode examples
To embed one document library with PDF-only results, use:
[document_engine_library file_types="pdf" layout="grid" filters="category,type"]To embed a viewer directly, Document Engine documents [document_engine_viewer] with a document ID, Media Library file ID, or URL, plus controls for height, zoom and toolbar options. Use the official shortcode reference to choose the appropriate parameters for your page.
Decision checklist before publishing a PDF
- Reader goal: Is the PDF primarily for reading, printing or downloading?
- Mobile: Does the preview remain usable on a narrow screen?
- Privacy: Should the URL work for visitors who are logged out?
- Search: Do users need to search this file or an entire collection?
- Accessibility: Does the PDF contain selectable, tagged text and a useful title?
Try it: Get Document Engine free or explore Document Engine Pro. For the exact settings, consult the official setup documentation.