Learn

Developer Guides

In-depth guides for building production Squarespace sites in Dev Mode. Written from real experience, not documentation rewrites.

Fundamentals

Getting Started with Dev Mode

Everything you need to know to enable Developer Mode, connect GitHub, and start building with custom code on Squarespace 7.0.

12 min read

The Page Creation Workflow

The 3-step process for creating pages in Dev Mode: .page.conf discovery, CMS registration, and renaming to .conf for a clean admin panel.

8 min read

CSS / LESS

LESS Architecture for Squarespace

How to structure your LESS files, work around broken @import, share design tokens across independently compiled stylesheets, and avoid the silent-fail trap.

15 min read

Debugging LESS Compilation Errors

One undefined variable kills ALL your styles silently. Learn how to check site.css?minify=false, catch errors, and debug the LESS compiler.

6 min read

SEO

JSON-LD Schema on Squarespace

How to add structured data to your Squarespace pages. Where to place it, which schema types matter, and how Google reads it from the body.

10 min read

Architecture

site.region Deep Dive

Understanding the global shell: what {squarespace-headers} actually does, how main-content injection works, and what you should (and shouldn't) put here.

10 min read

Custom Navigation Without the CMS

How to hardcode your nav in site.region, remove CMS dependency, and maintain full control over your navigation structure through GitHub.

7 min read

Workflow

GitHub as Source of Truth

The mental model shift: Squarespace as host, GitHub as CMS. How to keep your admin panel empty and manage everything through version control.

8 min read

More guides coming soon.

We're writing guides based on real production problems we've solved.

Browse Tools