You open a file stored in OneDrive for Business and see a blank preview pane or an error that says the file cannot be previewed. The file still downloads and opens normally in its desktop application. This mismatch between preview and download points to a specific issue with how OneDrive generates file previews on the server side rather than a problem with the file itself. This article explains why previews fail for valid files and provides the exact steps to restore preview functionality in your Microsoft 365 environment.
Key Takeaways: Restoring OneDrive File Previews
- OneDrive admin center > Settings > Sync > File preview: Controls whether previews are generated for synced files at the tenant level.
- PowerShell command Set-SPOTenant -DisableFilePreviewForUsers $false: Re-enables file preview generation for all users if it was disabled by an admin.
- Clear browser cache and cookies: Resolves stale preview data that shows a blank pane even though the file is healthy.
Why a Valid File Shows No Preview in OneDrive for Business
OneDrive for Business generates file previews by rendering a snapshot of the document on Microsoft servers. This preview is different from the file download. When you download a file, you receive the original binary data. When you request a preview, OneDrive calls a rendering service that processes the file and returns a static image or HTML view. If that rendering service cannot complete its task, you see a blank pane or an error message even though the file itself is intact.
Several factors block or break the preview generation pipeline. The most common root cause is a tenant-level setting that disables file previews for all users. This setting is controlled by the SharePoint Online admin and can be set unintentionally during a security review or migration. Another frequent cause is a file type that OneDrive does not support for preview. Microsoft maintains a list of previewable file types, and files with extensions outside that list will always show no preview. Less common causes include corrupted preview cache in the browser, a stale preview generation process on the server, or a file that exceeds the size limit for preview generation.
Because the file downloads correctly, you can rule out corruption of the file itself, permission issues, and network problems. The problem is isolated to the preview feature. This makes the fix targeted: you need to restore the preview service either at the tenant level, the browser level, or the file type level.
Steps to Fix the Missing Preview in OneDrive for Business
Follow these steps in order. Test the preview after each step to identify the specific cause.
- Check if the file type supports preview
Microsoft OneDrive previews common Office files such as .docx, .xlsx, .pptx, .pdf, .txt, and .jpg. It does not preview .exe, .zip, .iso, .dmg, .psd, or .ai files. Open the OneDrive website, select the file, and look at the preview pane. If the pane shows a message like “Preview not available for this file type,” the file extension is the reason. No fix is possible. Use the download option instead. - Clear your browser cache and cookies
Stale cached data can prevent the preview pane from loading. In Microsoft Edge or Chrome, press Ctrl+Shift+Delete. Select “All time” for the time range. Check “Cached images and files” and “Cookies and other site data.” Click “Clear now.” Reload the OneDrive page and test the preview. - Open the file in a private browser window
A private window bypasses cached data and extensions. In Edge, press Ctrl+Shift+N. In Chrome, press Ctrl+Shift+N. Sign in to your Microsoft 365 account and navigate to the file. If the preview works in the private window, the issue is caused by a browser extension or corrupted cache in your normal profile. Disable extensions one by one to find the culprit. - Check the tenant-level preview setting
Sign in to the Microsoft 365 admin center at admin.microsoft.com. Go to Settings > Org settings > OneDrive. Look for a setting called “File preview” or “Allow preview of files.” If it is turned off, turn it on and click Save. Wait 10 minutes for the change to propagate, then test the preview. - Use PowerShell to verify and enable preview generation
If the admin center setting is already on, an admin can run a PowerShell command to confirm. Open SharePoint Online Management Shell as an administrator. RunConnect-SPOService -Url https://[tenant]-admin.sharepoint.comusing your tenant name. Then runGet-SPOTenant | fl DisableFilePreviewForUsers. If the output showsDisableFilePreviewForUsers : True, runSet-SPOTenant -DisableFilePreviewForUsers $false. This re-enables preview generation for all users. Wait 10 minutes and test. - Re-upload the file to trigger a new preview
If the preview is broken for a single file, download the file, delete it from OneDrive, empty the recycle bin, and upload it again. OneDrive generates a new preview during the upload process. This fixes previews that failed due to a transient server error.
If OneDrive Still Shows No Preview After These Steps
Preview works for some files but not others in the same folder
This pattern indicates a file-specific issue rather than a tenant setting. Check the file size. OneDrive previews files up to 100 MB for Office documents and 10 MB for PDF files. Files larger than these limits will not generate a preview. Also check if the file is password-protected or encrypted. OneDrive cannot preview password-protected Office files or encrypted PDFs.
Preview pane is completely missing from the OneDrive interface
If the preview pane does not appear at all, the user may have collapsed it accidentally. On the OneDrive website, click the “View” menu in the top-right corner and select “Show preview pane.” The pane will reappear on the right side of the screen. If the option is grayed out, your admin has disabled the preview pane feature at the tenant level. Contact your Microsoft 365 administrator.
Error message says “Preview generation failed”
This error appears when the server-side rendering service encounters a timeout or crash. It is usually temporary. Wait 30 minutes and refresh the page. If the error persists, the file may contain corrupted internal data that does not affect the download but breaks the preview renderer. Open the file in its desktop application, save a copy, and re-upload the clean version.
Preview Pane vs Download: Key Differences for Troubleshooting
| Item | Preview Pane | File Download |
|---|---|---|
| Data source | Server-rendered snapshot of the file | Original binary file from storage |
| Processing location | Microsoft 365 rendering service | Direct from SharePoint storage |
| File size limit | 100 MB for Office files, 10 MB for PDF | Up to 250 GB per file |
| File type support | Limited to Office, PDF, image, and text formats | All file types supported by OneDrive |
| Effect of tenant setting | Can be disabled by admin | Not affected by preview settings |
| Dependency on browser cache | Uses cached preview data | Bypasses cache for download |
This table shows that the preview and download paths are independent. A file that downloads correctly but shows no preview is almost always a preview service issue. The fix targets the preview pipeline, not the file itself.
You can now identify and fix the missing preview problem in OneDrive for Business. Start by checking the file type and clearing your browser cache. If the issue is tenant-wide, use the admin center or PowerShell to re-enable preview generation. For a single stubborn file, re-uploading it forces a fresh preview. As an advanced tip, create a SharePoint Online audit log search for “FilePreviewGenerated” events to monitor preview success rates across your tenant.