Squrespace is a popular hosted website builder and CMS featuring slick dashboard and modern themes. It has been attracting lots of creative folks and commercial photographers. Even small ecommerce shops driven by this modern CMS are now popping up here and there.

And while Squarespace is still lacking support for third-party plugins in the way WordPress does, for example, we now have a new integration option for Squarespace that looks similar to the embed shortcode we have in our WordPress and Joomla plugins. The only requirement is having a place online where you can upload your published 360 or 3D product views as Squarespace's file hosting storage is currently very limited. Luckily, today having a spare 5-10 GB of web hosting space doesn't cost much and there're plenty of options.


Lets review step by step how to integrate your published webrotate 360 product views in Squarespace.

1) Publish your 360 product view using WebRotate 360 SpotEditor that you can download here. Here's a quick video that walks you through the basic steps.

2) Upload the contents of the 360_assets folder that you will see in the published folder under your SpotEditor project directory (or wherever you have chosen to output your published 360 product view) to your web hosting. You can upload it right away on publish in SpotEditor using our built-in FTP option (check "Upload assets only") or use a popular FTP client such as FileZilla or a browser based file manager that comes with your web hosting.

3) Once uploaded, note the location of the xml file inside the uploaded folder (e.g http://my-domain.com/360-views/my-product/my-product.xml). You'll will need this file's URL for the next steps.

4) Login to Squarespace and expand a page where you would like to integrate your published view.

5) Click Settings to configure this page and then select Advanced. Paste the following lines under Page Header Code and click Save.

<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
<script src="https://cdn.webrotate360.com/lib/imagerotator/3.6/js/imagerotator.js"></script>
<link href="https://cdn.webrotate360.com/lib/imagerotator/3.6/css/retina.css" rel="stylesheet"/>

Note 1: you may not need the first line (jQuery script) as your Squarespace theme may already include it. You may also replace retina.css with your viewer skin of choice (e.g, basic.css, thin.css, empty.css, round.css).

Note 2: if you don't want to paste these scripts on every page where you add your 3D product views, you can simply paste them under Code Injection->Header in your Squarespace Settings if you navigate to Settings->Advanced->Code Injection.

6) Add a new Squarespace Code block onto the page and click small </> icon on the right to expand the Embed Data field. Then paste the following under Embed Data and replacing the URL next to "xmlfile" with the one your have uploaded in the previous step and then change width and height to look good inside your page layout.

<div class="wr360embed-cdl" style="width:100%;height:600px;"

PS: there're a few options that you can configure in the last step. Below is an example with all of the available options listed in one place:

<div class="wr360embed-cdl" style="width:100%;height:600px;" data-imagerotator='{
    "graphics": "https://cdn.webrotate360.com/lib/imagerotator/3.6/img/retina",
    "basewidth": 1024,
    "minheight": 400
    "events": true,
    "name": "my-view",
    "rootpath": "http://my-cdn-for-images.com/product1/",
    "onready": your-javascript-callback}'>

Here's more details on each of the options:

  • basewidth - viewer width in pixel that you can set to allow the viewer window to scale not just horizontally, which works by default if a parent container has relative width, but also vertically as well. It usually represents your default viewer width as per your base (default) page layout design before any responsive scaling is applied. When it's set, the height of the viewer is automatically scaled relative to the scaled width.
  • minheight - if basewidth is specified, this setting represents the minimum viewer height in pixel. This can be helpful on small mobile screens where you may not want the viewer window height go beyond some fixed minimum. 
  • events - set it to true if your website has Google Analytics integrated and you would like to track user engagement with your 3D product views as per this recent article on our blog.
  • name - if specified, this name will appear in your Google Analytics event tracking so you could sort out the events by each view. 
  • rootpath - if you host images on a CDN server or if you need to have a single xml config for all of your 360 views, you can configure the image location using this path. Please find more details in our user guide under API / rootPath.
  • graphics - absolute path to a folder with hotspot indicator images (if you use hotspots!). Note that we share all of the skin folders that include default hotspot indicators via our CDN (Amazon S3) so this path will work https://cdn.webrotate360.com/lib/imagerotator/3.6/img/retina, and you can replace retina with basic, empty, round, thin, though they currently have the same hotspot images.
  • onready - pass your JavaScript API callback that accepts one parameter being our API object. Please refer to our user guide under API / apiReadyCallback for more details about various functions we currently offer via this API.