Document Loading Issues in Version 23.1 or Newer

28 Feb 20261 minute to read

If a PDF does not render after upgrading to v23.1+, use the checklist below to resolve common causes. The most frequent fix is calling dataBind() before load().

  1. Call pdfViewer.dataBind() before load(). Starting with v23.1, an explicit dataBind call is required to initialize data binding and render correctly.
<button id="viewer" onclick="documentLoad()">Load</button>
<div class="text-center">
    <ejs-pdfviewer id="pdfviewer" style="height:600px">
    </ejs-pdfviewer>
</div>

<script>
    function documentLoad() {
        var pdfViewer = document.getElementById('pdfviewer').ej2_instances[0];
        pdfViewer.serviceUrl = "https://document.syncfusion.com/web-services/pdf-viewer/api/pdfviewer";
        pdfViewer.dataBind();
        pdfViewer.load("https://cdn.syncfusion.com/content/pdf/annotations.pdf");
    }
</script>

  1. Verify the document source. Ensure the URL or path is valid and accessible.

  2. Check network connectivity. The viewer cannot fetch the document without a stable connection.

  3. Inspect console errors. Use browser developer tools to identify issues.

  4. Validate the initialization order. Initialize the viewer, call dataBind(), then call load().

  5. Update to the latest viewer version. Issues may be resolved in newer releases.

  6. Configure CORS correctly for cross-domain documents.

  7. Review Content Security Policy (CSP) settings. Ensure external resources are permitted. See the Content Security Policy troubleshooting guide for details.

This checklist typically resolves document loading issues after upgrading to v23.1+.