PDF Preview Fails in a Document Library: Root Cause and Fix

When you open a PDF file in a SharePoint document library, the browser should display a preview pane or an in-browser viewer. Instead, you see a download prompt, a blank page, or an error message saying the file cannot be previewed. This problem occurs because SharePoint’s PDF rendering service is blocked by browser settings, missing browser extensions, or disabled SharePoint features. This article explains the technical root cause of PDF preview failures and provides step-by-step fixes to restore the inline preview experience.

Why PDF Preview Fails in SharePoint Document Libraries

SharePoint uses a built-in PDF rendering engine to convert PDF pages into images for the preview pane. This engine relies on the browser to send the file to SharePoint’s rendering service without downloading it. When the browser intercepts the PDF request and tries to open it using its own PDF viewer, the preview fails. The root cause is a conflict between the browser’s default PDF handling and SharePoint’s rendering pipeline.

Three common technical factors cause this conflict:

Browser PDF Settings Override SharePoint

Modern browsers like Microsoft Edge, Google Chrome, and Mozilla Firefox include a built-in PDF viewer. When set to “Always download PDF files” or “Open in browser,” the browser takes control of the file before SharePoint can render it. The browser either downloads the file or opens it in a separate tab, bypassing the SharePoint preview pane entirely.

Missing or Disabled SharePoint PDF Viewer Extension

Microsoft provides a browser extension called “Microsoft SharePoint PDF Viewer” for Chrome and Edge. This extension tells the browser to hand PDF files to SharePoint for rendering instead of using the browser’s native viewer. If the extension is missing, disabled, or blocked by group policy, SharePoint cannot request the file for preview.

Tenant-Level PDF Preview Setting Disabled

SharePoint administrators can disable PDF preview at the tenant level. When disabled, the system treats PDF files like any other non-previewable document and forces a download. This setting overrides any browser or extension configuration.

Steps to Restore PDF Preview in SharePoint

Follow these steps in order. Test the PDF preview after each step to identify the exact cause.

Step 1: Change Browser PDF Settings

1. Open browser PDF settings
   In Microsoft Edge, go to edge://settings/content/pdfDocuments. In Google Chrome, go to chrome://settings/content/pdfDocuments. In Firefox, go to about:preferences#general and find the Applications section.
2. Disable “Always download PDF files”
   In Edge and Chrome, turn off the toggle for “Always download PDF files.” In Firefox, change the action for PDF from “Save File” to “Preview in Firefox” or “Use Adobe Acrobat (if installed).”
3. Restart the browser
   Close all browser windows and reopen them. Navigate to the SharePoint document library and click a PDF file.

Step 2: Install or Enable the SharePoint PDF Viewer Extension

1. Open the browser extension store
   In Edge, go to the Edge Add-ons store. In Chrome, go to the Chrome Web Store. Search for “Microsoft SharePoint PDF Viewer.”
2. Install the extension
   Click “Get” or “Add to Chrome.” Confirm the installation when prompted.
3. Enable the extension
   After installation, click the puzzle icon in the browser toolbar. Find “Microsoft SharePoint PDF Viewer” and ensure the pin is visible. Right-click the extension and select “Manage extension.” Toggle “Allow access to file URLs” to on.
4. Refresh the SharePoint page
   Reload the document library and test the PDF preview.

Step 3: Verify Tenant-Level PDF Preview Setting

1. Open SharePoint admin center
   Sign in to Microsoft 365 admin center as a SharePoint admin. Select “SharePoint” from the admin center menu.
2. Go to Settings
   In the left navigation, select “Settings.” Scroll down to the “PDF preview” section.
3. Enable PDF preview
   Make sure the toggle for “Allow PDF preview” is set to On. If it is Off, turn it On and click “Save.”
4. Wait for propagation
   Changes can take up to 30 minutes to apply across all sites. After waiting, test the PDF preview again.

If PDF Preview Still Fails After the Main Fix

If the preview still does not appear, check for these additional issues.

PDF File Is Too Large or Corrupted

SharePoint’s PDF preview engine has a file size limit of 10 MB. Files larger than 10 MB will not render in the preview pane. Additionally, a corrupted PDF file can cause the rendering service to fail. Try uploading a smaller, known-good PDF to test.

Browser Extensions Conflict with SharePoint

Other extensions such as ad blockers, privacy tools, or PDF editors can interfere with SharePoint’s request to render the file. Temporarily disable all other extensions and test the preview. If it works, re-enable extensions one by one to find the conflicting one.

SharePoint Feature “PDF Rendering” Is Disabled at Site Level

Site collection administrators can disable the PDF rendering feature for a specific site. Go to Site Settings > Site Collection Features. Verify that “PDF Rendering” is set to Active. If it is Inactive, click “Activate.”

PDF Preview in SharePoint: Browser vs Extension vs Tenant Setting

Item	Browser PDF Setting	SharePoint PDF Viewer Extension	Tenant PDF Preview Setting
Description	Controls whether the browser downloads or displays PDF files	Forces the browser to send PDF files to SharePoint for rendering	Enables or disables the PDF preview feature for all sites in the tenant
Where to configure	Browser settings page (edge://settings/content/pdfDocuments)	Chrome Web Store or Edge Add-ons store	SharePoint admin center > Settings > PDF preview
Effect when disabled	Browser downloads PDF instead of previewing	SharePoint cannot request the file; browser uses its own viewer	All PDF files are treated as non-previewable documents
Fix action	Turn off “Always download PDF files”	Install and enable the extension; allow file URL access	Toggle “Allow PDF preview” to On

These three settings work together. The browser must hand the file to SharePoint, the extension must be present, and the tenant must allow previews. A problem in any one of them breaks the preview.

Conclusion

You can now identify why PDF preview fails in a SharePoint document library and apply the correct fix. Start by checking the browser PDF setting, then install the SharePoint PDF Viewer extension, and finally verify the tenant-level PDF preview setting. If the issue persists, test with a smaller file and disable conflicting browser extensions. For ongoing reliability, set a group policy in Edge or Chrome to force-enable the SharePoint PDF Viewer extension for all users in your organization.