Using the Script Loader

Squarespace's script loader minifies your code and allows you to combine all of your JavaScript files into one, cutting down on HTTP requests. Loading JavaScript in Squarespace is very similar to the standard script tag syntax in HTML. The syntax is outlined in the code sample below.

<squarespace:script src="plugin.js" combo="true" />
<squarespace:script src="site.js" combo="true" />

NOTE: The script's src path is relative to the template /scripts folder.

Using your own Javascript Preprocessor

You can use any javascript workflow tool, like NPM, gulp, browserify or webpack. You can include the compiled code in your /scripts folder, and link to those files using regular script tags, or the Squarespace Script Tag.

Including External Third Party Libraries

You can use libraries hosted on an external server or CDN, but we recommend having a local fallback in case the CDN isn’t available. Here’s an example:

<script src="//code.jquery.com/jquery-2.2.1.min.js"></script>
<script>
   window.jQuery || document.write('<script src="scripts/jquery-2.2.1.min.js"><\/script>')
</script>