Skip to main content

Standalone Browser Scripts

Each standalone release script is available at https://cdn.sheetjs.com/.

The current version is 0.18.12 and can be referenced as follows:
<!-- use version 0.18.12 -->
<script lang="javascript" src="https://cdn.sheetjs.com/xlsx-0.18.12/package/dist/xlsx.full.min.js"></script>

The latest tag references the latest version and updates with each release:

<!-- use the latest version -->
<script lang="javascript" src="https://cdn.sheetjs.com/xlsx-latest/package/dist/xlsx.full.min.js"></script>
danger

A number of services host older versions of the SheetJS libraries. Due to syncing issues, they are generally out of date.

They are known CDN bugs.

https://cdn.sheetjs.com/ is the authoritative source for SheetJS modules.

Browser Scripts

xlsx.full.min.js is the complete standalone script. It includes support for reading and writing many spreadsheet formats.

<!-- use xlsx.full.min.js from version 0.18.12 -->
<script lang="javascript" src="https://cdn.sheetjs.com/xlsx-0.18.12/package/dist/xlsx.full.min.js"></script>

A slimmer build is generated at dist/xlsx.mini.min.js. Compared to full build:

  • codepage library skipped (no support for XLS encodings)
  • no support for XLSB / XLS / Lotus 1-2-3 / SpreadsheetML 2003 / Numbers
  • node stream utils removed
How to integrate the mini build (click to show)

Replace references to xlsx.full.min.js with xlsx.mini.min.js. Starting from scratch, a single script tag should be added at the top of the HTML page:

<!-- use xlsx.mini.min.js from version 0.18.12 -->
<script lang="javascript" src="https://cdn.sheetjs.com/xlsx-0.18.12/package/dist/xlsx.mini.min.js"></script>

Internet Explorer and Older Browsers

For broad compatibility with JavaScript engines, the library is written using ECMAScript 3 language dialect. A "shim" script provides implementations of functions for older browsers and environments.

Due to SSL compatibility issues, older versions of IE will not be able to use the CDN scripts directly. They should be downloaded and saved to a public directory in the site:

Add a script reference to the shim before the script tag that loads xlsx.js:

<!-- add the shim first -->
<script type="text/javascript" src="shim.min.js"></script>
<!-- after the shim is referenced, add the library -->
<script type="text/javascript" src="xlsx.full.min.js"></script>

Web Workers

The standalone scripts can be loaded using importScripts at the top of the worker scripts:

importScripts("https://cdn.sheetjs.com/xlsx-0.18.12/package/dist/shim.min.js");
importScripts("https://cdn.sheetjs.com/xlsx-0.18.12/package/dist/xlsx.full.min.js");

ECMAScript Module Imports in a SCRIPT TAG

caution

This section refers to imports using script type="module". For imports in modern projects using Webpack or React or Angular or VueJS, the installation is described in the next section.

The ECMAScript Module build is saved to xlsx.mjs and can be directly added to a page with a script tag using type="module":

<script type="module">
import { read, writeFileXLSX } from "https://cdn.sheetjs.com/xlsx-0.18.12/package/xlsx.mjs";
</script>

If Encoding support is required, cpexcel.full.mjs must be manually imported:

<script type="module">
/* load the codepage support library for extended support with older formats */
import { set_cptable } from "https://cdn.sheetjs.com/xlsx-0.18.12/package/xlsx.mjs";
import * as cptable from 'https://cdn.sheetjs.com/xlsx-0.18.12/package/dist/cpexcel.full.mjs';
set_cptable(cptable);
</script>

Dynamic imports with import() can be used in data export scenarios. This example will download the library only when the export button is pressed:

<button id="xport">Export</button>
<script type="module">
xport.addEventListener("click", async() => {

/* dynamically import the library in the event listener */
const XLSX = await import("https://cdn.sheetjs.com/xlsx-0.18.12/package/xlsx.mjs");

const wb = XLSX.utils.book_new();
const ws = XLSX.utils.aoa_to_sheet([["a","b","c"],[1,2,3]]);
XLSX.utils.book_append_sheet(wb, ws, "Sheet1");
XLSX.writeFile(wb, "SheetJSESMTest.xlsx");
});
</script>

Bower

caution

Bower is deprecated and the maintainers recommend using other tools.

Bower plays nice with the CDN tarballs:

npx bower install https://cdn.sheetjs.com/xlsx-0.18.12/xlsx-0.18.12.tgz

Bower will place the standalone scripts in bower_components/js-xlsx/dist/