Skip to content

Foxit PDF SDK for Web v12.0 ​

Release date: November 16, 2026

Overview ​

This release adds a 64-bit front-end rendering engine, enhances 20 capabilities across view modes, search and comparison, annotations and measurement, and accessibility, and includes 36+ bug fixes. When upgrading from 11.1, review "Breaking changes" first.

Breaking changes ​

When upgrading from v11.1, the following changes may require code or deployment updates.

Custom PDF Action entry ​

ActionCallbackManager is deprecated. To handle PDF Actions (for example customize or suppress the default prompt when opening an external link), set customs.actionExecutor on the PDFViewCtrl.PDFViewer constructor, or viewerOptions.customs.actionExecutor on UIExtension.PDFUI. JavaScript Actions still run inside the SDK and never enter actionExecutor.

Beforev12.0
EntryScattered callbacks on ActionCallbackManagerPDFViewer customs.actionExecutor; PDFUI viewerOptions.customs.actionExecutor
Return value—true means handled (skip default); false means continue with the default

Code sample:

javascript
const pdfViewer = new PDFViewCtrl.PDFViewer({
    customs: {
        actionExecutor: async (options) => {
            // Decide whether to handle the current Action (for example an external link)
            // Return true if handled; otherwise return false to keep the SDK default
            return false;
        }
    }
});

Required action: Move existing ActionCallbackManager callbacks to actionExecutor and handle the relevant Actions for your product. Version differences: Action version history. For migrating older Action get/set APIs, see PDF Action API Migration Guide.

Front-end rendering engine selects 32 / 64-bit by browser ​

From 12.0, Foxit PDF SDK for Web ships 64-bit and 32-bit front-end rendering engines. When jr.wasm64 is omitted, the SDK picks one based on whether the browser supports WebAssembly Memory64.

Code sample:

javascript
const pdfViewer = new PDFViewCtrl.PDFViewer({
    jr: {
        wasm64: true // true for 64-bit, false for 32-bit; omit for automatic selection
    }
});

Required action: When self-hosting, deploy both jr-engine/gsdk/32 and jr-engine/gsdk/64. If you deploy only one, set jr.wasm64 to the matching true or false and keep that subdirectory complete. Keep jr.enginePath pointed at the jr-engine/gsdk root—do not point it at the 32 or 64 subdirectory. See Front-end rendering engine · 32-bit and 64-bit.

View modes are no longer loaded via addon scripts ​

These scripts are removed from the package:

  • lib/PDFViewCtrl/addon/HContinuousViewMode.js
  • lib/PDFViewCtrl/addon/FacingContinuousViewMode.js
  • lib/PDFViewCtrl/addon/FacingPageViewMode.js

Built-in view modes are exported from PDFViewCtrl.viewMode. MultipageViewMode is deprecated; use FacingContinuousViewMode, or FacingPageViewMode.extend to customize pages per row.

Code sample:

javascript
const { FacingContinuousViewMode } = PDFViewCtrl.viewMode;
const viewModeManager = pdfViewer.getViewModeManager();
viewModeManager.register(FacingContinuousViewMode);
viewModeManager.switchTo(FacingContinuousViewMode.getName());

const ThreePageFacing = PDFViewCtrl.viewMode.FacingPageViewMode.extend(
    'facing-3-page-view-mode',
    3
);
viewModeManager.register(ThreePageFacing);
viewModeManager.switchTo(ThreePageFacing.getName());

Required action: Remove references to the scripts above and use getViewModeManager().register / switchTo. Projects that only use UIExtension built-in page-mode buttons and never referenced those scripts need no change.

Legacy browser polyfill scripts removed ​

The package no longer includes PDFViewCtrl.polyfills.js or UIExtension.polyfills.js. PDFViewCtrl.full.js is composed of PDFViewCtrl.vendor.js and PDFViewCtrl.js; UIExtension.full.js works the same way.

Code sample:

html
<script src="../FoxitPDFSDKForWeb/lib/PDFViewCtrl.vendor.js"></script>
<script src="../FoxitPDFSDKForWeb/lib/PDFViewCtrl.js"></script>

Required action: Remove references to the two polyfill scripts. Load *.full.js, or load the matching vendor.js plus PDFViewCtrl.js / UIExtension.js. See Scripts and third-party libraries.

Engine no longer ships Brotli precompressed files ​

Before 12.0, jr-engine/gsdk shipped both gsdk.wasm and gsdk.wasm.brotli. The SDK requested gsdk.wasm.brotli by default and decompressed it in the browser.

From 12.0, the package keeps only *.wasm and no longer includes gsdk.wasm.brotli. The SDK requests those *.wasm files on init. If the file server returns gzip or Brotli based on Accept-Encoding, the browser decompresses before the SDK receives the bytes.

See Best practices · Transfer compression for front-end rendering engine wasm modules.

New features and enhancements ​

Engine and loading ​

Viewing ​

  • Enhanced scrolling and page layout for continuous, facing, and related view modes, for more stable jumps and continuous browsing on long documents. Added FacingPageViewMode.extend to set pages per row in facing mode.

Search and comparison ​

  • Enhanced advanced search so results and progress update during the run, and search can stop before completion.
  • Added getCompareDocumentParamsService().setMarkingColor() to configure replace, insert, and delete legend colors so the legend matches on-page marks.
  • Added getCompareFilterOptionsService().setDefaultFilterOptions() to set default filter options for the next opened result. Added updateFilterOptions() to update checkboxes on the currently open result.

Annotations and measurement ​

  • Enhanced multi-page and cross-page stamps. Reusing stamp resources can cut wait time by about ninety percent.
  • Enhanced the annotation list panel. When there are about 500 or more annotations, loading shows a progress hint.
  • Added setCurrentUserAsAnnotationAuthor(true) to use the current user as author when pasting annotations.
  • Added permission selectable. When it is missing from the permission set, annotations still display but are not selectable.
  • Added PDFDoc.removeAllAnnots() to remove all annotations from a document.
  • Added PDFPage.getAnnotsByRect(rect, tolerance?) to get annotations by rectangle.
  • Added constructor option enableBatchAnnotResize. Set to true to resize multiple selected annotations.
  • Enhanced the annotation panel to show rich text and to write both rich text and plain text on save.
  • Enhanced Distance measurement create and edit flows to match Foxit desktop PDF editor behavior.

Actions ​

  • Added actionExecutor to customize or suppress default prompts for PDF Actions such as external links. Set it on PDFViewer constructor customs, or on PDFUI viewerOptions.customs. Migration: see Custom PDF Action entry above.

Accessibility ​

  • Enhanced keyboard and focus behavior. Tab stays inside modal dialogs; sidebars can receive Tab focus; lists, trees, dropdowns, and context menus support arrow keys and Enter.

Bug fixes ​

Rendering and opening ​

  • Fixed openPDFByHttpRangeRequest returning an undefined document object after a correct password was provided
  • Fixed incorrect target-page jumps when opening certain files that have an OpenAction
  • Fixed occasional long blank screens or errors when previewing complex drawings
  • Fixed out-of-memory issues when browsing files in a WebView embedded in a mobile app
  • Fixed view mode, zoom, and scroll position not being restored after clearing a signature and reopening the document
  • Fixed blank screens in specific cases when zooming and turning pages
  • Fixed jumping to the top-left of the current page when switching to single-page mode while zoomed
  • Fixed slow document open performance
  • Fixed a false “file cannot be opened” report when removing an element class inside an iframe
  • Fixed inability to open larger PDF files

Annotations ​

  • Fixed Callout annotations getting stuck when moved near the leader end
  • Fixed occasional inability to draw other annotations after drawing a measurement annotation
  • Fixed the selection box not showing when a Callout is selected
  • Fixed Callouts that could not be selected after they were added
  • Fixed annotations from certain documents not appearing in the annotation panel
  • Fixed stamps and body text not displaying after opening a stamp on a page that was not currently shown from the annotation panel
  • Fixed annotation hover tips not appearing on touchscreen Windows laptops
  • Fixed unknown annotation types with appearance streams not rendering
  • Fixed inconsistent annotationAdd event order between mobile and desktop
  • Fixed area highlights rendering twice when shown, stacked, or intersecting text highlights
  • Fixed multiple point records being created from repeated clicks at the same position
  • Fixed stuttering when moving annotations
  • Fixed stuttering when moving cloud annotations
  • Fixed Callout arrows disappearing when border width is 0
  • Fixed incorrect fonts read after editing FreeText annotations
  • Fixed rotation display issues for annotation XFDF exported from 11.0.6 when opened in later versions
  • Fixed rotation values read after importAnnotsFromJSON not matching the imported data
  • Fixed getBorderWidth() return values not matching values set with setBorderWidth()
  • Fixed imported annotations not displaying at certain zoom levels
  • Fixed annotation box fonts changing after reselect or move when a font was set
  • Fixed FreeText paste failures in Firefox and Safari, and inability to write the system clipboard in Safari
  • Fixed IME composition text not showing live during pre-edit
  • Fixed Typewriter annotation placement not matching the click position

Other ​

  • Fixed insufficient isolation of PDF JavaScript in the Worker
  • Fixed raw HTML tags showing in the attachment panel description column
  • Fixed grantQueryLocalFontsPermission not taking effect when granted was passed