'%3e%3cpath%20d='M8%200C12.4183%200%2016%203.58172%2016%208C16%2012.4183%2012.4183%2016%208%2016C3.58172%2016%200%2012.4183%200%208C0%203.58172%203.58172%200%208%200ZM11.6162%204.38379C11.2257%203.99337%2010.5927%203.99338%2010.2021%204.38379L8%206.58594L5.79785%204.38379C5.40732%203.99334%204.77429%203.99329%204.38379%204.38379C3.99331%204.77429%203.99335%205.40733%204.38379%205.79785L6.58594%208L4.38379%2010.2021C3.99348%2010.5927%203.99341%2011.2257%204.38379%2011.6162C4.77426%2012.0066%205.40734%2012.0065%205.79785%2011.6162L8%209.41406L10.2021%2011.6162C10.5927%2012.0066%2011.2257%2012.0067%2011.6162%2011.6162C12.0067%2011.2257%2012.0066%2010.5927%2011.6162%2010.2021L9.41406%208L11.6162%205.79785C12.0066%205.40735%2012.0066%204.77429%2011.6162%204.38379Z'%20fill='%23080E17'%20fill-opacity='0.46'/%3e%3c/g%3e%3cdefs%3e%3cclipPath%20id='clip0_3761_713'%3e%3crect%20width='16'%20height='16'%20fill='white'/%3e%3c/clipPath%3e%3c/defs%3e%3c/svg%3e)
Fix SharePoint PDF Viewer Links Showing Blank or Black Pages
Question details
Users need a solution to correctly generate valid SharePoint PDF viewer links because manually built links often fail to render.
- Product
- Microsoft SharePoint
- Device & OS
- not provided
- Scenario
- Generating or sharing URL links to view PDF files directly in the SharePoint web viewer.
- Observed behavior
- The SharePoint PDF viewer loads a blank or black page when the ID and parent URL parameters have incorrect letter casing.
Ensure you have the exact URL parameter string that is failing and verify that your browser cache is cleared so it does not load a previously failed link state.
Correct the Letter Casing in URL Parameters Manually
Since the ID and parent parameters are strictly case-sensitive, manually ensuring the correct casing will bypass the blank page issue.
The new SharePoint PDF viewer enforces strict case sensitivity for URL parameters. If you are constructing links manually or using a custom script, any mismatch in capitalization will cause the file to fail to load.
Copy the SharePoint PDF link that is showing a blank or black screen and paste it into a plain text editor like Notepad.
Check the URL query string for the parameters starting with '?id=' or '&parent='.
Ensure that the casing of the directory paths and identifiers perfectly matches the exact structural casing found in your SharePoint environment.
Paste the updated URL back into your browser to verify that the PDF document loads correctly in the viewer.
Support the Official Feature Request
An official generator for 'People with existing access' links is pending Microsoft's implementation. Upvoting the feedback helps prioritize the fix.
Read and Edit PDFs Seamlessly with WPS Office
Avoid web-based PDF viewer glitches entirely. Sync your SharePoint libraries to your desktop and use WPS Office for a robust, native PDF reading and editing experience without relying on complex URL parameters.
- 1. Download WPS Office: Visit the official WPS website and download the free desktop application for your operating system.
- 2. Sync SharePoint locally: Use OneDrive to sync your SharePoint document library directly to your computer's local file explorer.
- 3. Open PDFs natively: Double-click the synced PDF files to open them instantly in WPS Office, completely bypassing browser URL limitations.
Frequently Asked Questions
Why does my SharePoint PDF link open a black screen?
This often happens because the new SharePoint PDF viewer enforces strict case-sensitivity for the 'ID' and 'parent' URL parameters. If the casing is incorrect, the viewer fails to locate and render the file.
Is there a Microsoft Graph API endpoint to generate these PDF links?
Currently, there is no official Microsoft Graph service that natively generates 'People with existing access' links with guaranteed proper parameter casing. This issue has been submitted as feedback to Microsoft.
How can I avoid URL issues when viewing SharePoint PDFs?
You can sync your SharePoint document library to your local file explorer using OneDrive. Once synced, you can open the PDFs using a native desktop application like WPS Office, completely avoiding web viewer URL errors.
