Docs T
  • Try for free
  • Downloads
  • Demo
  • Support
  • Contact Sales
  • Contact Sales
Web
Troubleshooting
Overview
Get started
  • Overview
  • React + Vite
  • Next.js
  • TypeScript
  • Other frameworks
    • Vue
    • JavaScript + Vite
    • Nuxt
    • Svelte
    • Angular
    • ASP.NET
    • Blazor
    • Electron
    • Flutter
    • jQuery
    • Laravel
    • PHP
    • PWA
  • Vibe code
    • Vibe code with Web SDK
guides
  • Introduction
  • Self-host SDK assets
  • Viewer
    • Overview
    • Page layout and scroll
    • Streaming
    • Linearized downloads
    • Mobile responsive
    • Viewing options
      • Fullscreen mode
      • Magazine viewer
      • Presentation mode
    • Zooming
    • Accessibility
      • Features
      • Text-to-speech
    • Fonts
      • Introduction to fonts
      • Supported fonts
      • Font substitution
      • Dynamic font loading
      • Custom fonts
    • Rendering
      • PDF pages
      • Render on canvas
      • PDF forms
      • Coordinate space
      • Watermarks
    • Custom annotation toggle
    • PDF JavaScript support
    • Permissions
    • Troubleshooting
  • Open a document
    • Overview
    • From a remote URL
    • From a Blob
    • From an ArrayBuffer
    • From local storage
    • From Base64 data
    • From Document Engine
    • From DWS Viewer API
    • Secured documents
      • Password protected
      • HTTP authenticated
      • Encrypted
    • Open on a specific page
  • Save a document
    • Overview
    • To local storage
    • To an ArrayBuffer
    • To a remote server
    • To Document Engine
    • Incremental saving
    • Auto-save
    • Save as
    • Detect unsaved changes
    • Without annotations
  • User interface
    • Overview
    • Theming
      • CSS styling
      • Icons
      • Custom theme
      • Dark theme
    • UI slots customization
      • Introduction
      • Custom sidebars
      • Set UI customization configuration
      • Example: Comment thread
      • Supported slots
    • Main toolbar
      • Remove a tool
      • Rearrange
      • Create a new tool
      • Customize existing tools
      • Print button
      • Download/export button
      • Dropdown groups
      • Responsive groups
      • Hide the toolbar
      • Placement
      • Activate or deactivate tools
      • Page label navigation
      • Pager display
    • Sidebar
      • Hide or show
      • Thumbnail preview
      • Document outline
      • Annotations list
      • Bookmarks
      • Layers (OCGs)
      • Signatures list
      • Customization
    • Text selection
      • Create a new tool
      • Customize existing tools
      • Rearrange
      • Remove a tool
      • Remove all tools
      • Tooltip
    • Annotations
      • Inspector
      • Contextual tooltip
      • Stamps
      • Hide the delete button
      • Presets
      • Variant buttons
    • Annotation toolbar
      • Customize existing tools
      • Create a new tool
      • Remove a tool
      • Rearrange
      • Responsive groups
    • Color picker
      • Add custom color presets
      • Custom color picker
    • Signatures
      • Electronic signatures
      • Creation modes
      • Signature fonts
      • Invisible signing
      • Validation status
    • Document Editor
      • Overview
      • Customization
    • Date and time picker
    • Form Designer
    • Redaction
    • Search
    • Overlays
    • Create a toolbar
    • View state
    • Localization
    • Right-to-left languages
    • Troubleshooting
  • AI Assistant
    • Integrate viewer with AI Assistant
  • Annotations
    • Overview
    • Introduction to annotations
      • What are annotations?
      • Annotation types
      • Data formats
      • Geometry primitives
      • Working with annotations
      • Media annotations
    • Synchronization
      • Overview
      • Storing annotation data
      • Conflict resolution
    • Save
      • Overview
      • Embed into a PDF
      • To external storage
      • Auto save
    • Import and export
      • XFDF
      • Instant JSON
      • With Document Engine
      • Database
    • Create, edit, and remove
      • Create
      • Edit
      • Remove
      • Permissions
      • Add an image
      • Detect changes
      • Annotation flags
      • Undo and redo
      • Cut, copy, paste, duplicate
      • Author name
      • Select annotations
      • Rich text
    • Customization
      • Display logic
      • Appearance streams
      • Annotation customization
      • Hiding annotations
      • Default properties
      • Store custom data
      • Annotation notes
    • Comments and replies
      • Comments
      • Replies
    • Stamp a document
      • Built-in stamps
      • Stamp configuration
    • Flatten
    • Annotate on images
      • Create, edit, and remove
      • Specification
    • Freeform rotation
    • PDF actions
      • PDF actions support
      • Link annotations
    • Headless annotation
  • Forms
    • Overview
    • Introduction to forms
      • What are forms?
      • Form fields
      • Data formats
    • Fill form fields
      • Programmatic
      • Using Web SDK with Document Engine
      • Import from Instant JSON
      • Import from XFDF
      • Import from a database
      • Using the UI
      • Attach a file
      • Add an image
      • Detect user input
      • Permissions
      • Fonts
      • Headless form fill
    • Extract form data
    • Read form fields
    • Submit or save
      • To an external source
      • Document Engine
      • Embed data into a PDF
      • Auto saving
    • Create, edit, and remove
      • Form Creator
      • Create a fillable form
      • Add a signature field
      • Edit fields
      • Remove fields
      • Form field flags
    • Flatten
    • PDF actions support
    • JavaScript validation
  • Instant synchronization
    • Overview
    • Get started
    • Authentication
    • Instant layers
    • Permissions
      • Overview
      • Content ownership
      • Set permissions
      • Edit permissions
      • Example
  • Signatures
    • Overview
    • Introduction to signatures
    • Electronic signatures
      • Add an eSignature
      • Signature storage
      • Sign with a certificate
    • Digital signatures
      • Overview
      • Architectures for signing
      • Signature standards
      • Signature lifecycle
        • Overview
        • Certificates for signing
        • Add a signature field
        • Sign in a browser
        • Sign via Document Engine
        • Sign via DWS Processor API
        • Signature appearance
        • Validation
      • Supported formats
      • Integrations
        • Overview
        • AWS CloudHSM
        • GlobalSign
      • Troubleshooting
    • Fill and sign forms
    • Headless signing
  • Editor
    • Overview
    • Editing text through the UI
    • Editing text programmatically
    • Merge or combine
    • Page manipulation
      • Rotate
      • Crop
      • Move or copy
      • Remove
      • Add margins
    • Add a page
    • Split
    • Add an image
    • Headless editing
    • Page label
    • Built-in UI
    • Replace text
    • Add Bates numbering
    • Backend processing
  • PDF generation
    • Overview
    • From a PDF form
    • From a PDF template
    • From a Word template
    • From images
    • PDF reports
    • Thumbnail preview
    • Headless PDF generation
  • Conversion
    • Overview
    • Office to PDF
    • PDF to Office
    • To PDF/A
    • Image to PDF
    • PDF to image
    • Text to PDF
    • Scan to searchable PDF
    • Image to text
    • Headless conversion
  • Extraction
    • Overview
    • Parse content
    • Read text
    • Text extraction
    • Page extraction
    • Selected text
  • Redaction
    • Overview
    • Introduction to redaction
    • Programmatically
    • Search and redact
    • Preset patterns
    • Regex patterns
    • Built-in UI
    • Headless redaction
  • OCR
  • Barcodes
  • Document security
    • Overview
    • Prevent print or download
    • Open without downloading
    • Add a watermark
    • Password protect
    • With Document Engine
  • Search
    • Overview
    • Text search
    • Annotation search
    • Built-in UI
  • TWAIN scanning
  • Comparison
    • Compare documents
    • Compare text
    • Compare text using AI
  • Measurements
    • Overview
    • Distance
    • Area
    • Configure
  • Layers (OCGs)
    • Overview
    • Introduction to OCGs
    • Show and hide
    • Built-in UI
  • Bookmarks and outlines
    • Overview
    • Introduction
    • Bookmarks
      • Create
      • Edit
      • Remove
      • Detect changes
      • Built-in UI
    • Outlines
      • Create
      • Edit
      • Remove
  • Events
    • Overview
    • Annotations
    • Forms
    • Text selection
    • Bookmarks
    • Events
  • Print
    • Overview
    • Auto print
    • Without opening a PDF
    • From Base64
    • From a Blob
    • From a URL
    • Disable printing
    • Print modes
    • Programmatic
    • Without annotations
  • Instant JSON
    • Overview
    • How it works
    • Annotations schema
      • Annotations
      • File attachments
      • Form field values
      • Form field types
      • Bookmarks
      • Actions
      • Comments
    • Convert to XFDF
  • Performance
    • Streaming
    • Linearized downloads
    • Best practices
    • Annotation diff
    • Caching techniques
  • Best practices
  • Troubleshooting
  • Knowledge base
API reference
Code samples
Releases
  • Upgrading Web SDK
  • 1.10
  • 1.9
  • 1.8
  • 1.7
  • 1.6
  • 1.5
  • 1.4
  • 1.3
  • 1.2
  • 1.1
  • 1.0
  • Changelog

About
  • Operational modes
  • Capability and component comparison
  • Browser support
  • File type support
  • Framework support
  • Licensing
  • Migration guides
    • Mozilla PDF.js
    • PDFTron WebViewer

Nutrient Portal
  1. Web
  2. Troubleshoot

Troubleshooting

Copy page Copy page as Markdown for LLMs View as Markdown View this page as plain text Open with ChatGPT Explain the page with ChatGPT Open with Claude Explain the page with Claude Open with Grok Explain the page with Grok

Troubleshoot common issues you might encounter when setting up Nutrient Web SDK.

Rendering

  • Font rendering
  • The complexities for rendering PDFs
  • Inconsistent fonts
  • PSPDFKit doesn’t show the PDF form

User interface

  • Optimizing for mobile

License

  • Adding the license key
  • License troubleshooting
  • Watermark still appearing with license key

Miscellaneous

  • Bug reporting
  • Nightlies
  • Common issues when integrating
  • Common issues integrating into test suites
  • TypeScript
  • ChunkLoadError during PSPDFKit-to-Nutrient migration in Ember
  • Split undefined error

Was this helpful?

Thank you for your feedback!

Something went wrong. Please try again or let us know.

Contact Us

On this page

    Copyright 2025 Nutrient. All rights reserved.

    About Contact Legal