The default template for developers getting started with a project on Squarespace. This is a minimal template. No tweaks, no web fonts, no static assets, no static pages, no system collections, no collection features, no modules at all.
Just the basics.
See the Developer Getting Started page for an step-by-step guide for getting started with the Squaresapce Developer Platform. You can create a new website using this template by visiting base-template.squarespace.com and clicking the "Create a Site Like This" button. This template is also available on GitHub.
Each Squarespace website is based on a template like this one. Templates contain regular web files like CSS and JavaScript. In addition, Squarespace recognizes a few special file types:
Squarespace template files are written in JSON Template, also known as JSON-T. It is a simple yet expressive template language. JSON-T files have different extensions depending on the type of file, for example .list
, .item
, and .region
.
Template LESS files (.less) are processed through the LESS preprocessor. LESS extends CSS with dynamic behavior such as variables, mixins, operations and functions.
Squarespace template files are organized using the following folder structure at the root of your site:
- assets: design assets — example: images, fonts and icons
- blocks: reusable blocks of JSON-T (AKA partials) — ex: navigation.block
- collections: collection files — [collection].list, [collection].item, [collection].conf
- scripts: Javascript files — site.js
- styles: stylesheet files — styles.css, styles.less
- [root]: sitewide files — site.region, template.conf
At the very minimum, your template needs a .region
file and a template.conf
.
Typically this file is used as the global site template – containing the site header, footer, and sidebars. This is like the index.html
of your site. Every template must have at least one .region
file. Simple templates will have a single .region
, more advanced templates will have multiple .region
files describing header, body, and footer variants. Regions files live in the root directory of a template.
See the Layouts & Regions documentation for more details.
Contains the configuration settings for the template. This is where you can name your template, specify layouts, add navigation sections, specify stylesheets, and other general site options. Template configuration files must live in the root directory of a template.
See the Template Configuration documentation for more details.
For further reading please consult the Squarespace Template Overview and other documentation on the Squarespace developers website.