Note: While our most popular guides have been translated into Spanish, some guides are only available in English.

Squarespace Developer Platform FAQ

This guide covers common questions about The Squarespace Developer Platform, an advanced tool that developers can use to customize their site beyond our built-in custom code tools. The Developer Platform is designed for people with advanced coding knowledge. If you’re already using the Developer Platform, visit our Developer Docs.

The Developer Platform is a Premium feature available in version 7.0 on these plans:
  • Legacy Website Personal
  • Website Business
  • Website Commerce (no longer available)
  • Website Professional (no longer available)
  • Commerce Basic
  • Commerce Advanced

Who is the Developer Platform for?

Most Squarespace users don’t need the Developer Platform because Squarespace provides built-in options like custom HTML, CSS, and Javascript, which allow you to highly customize your site. Some users, like developers and design agencies, require more customization that they can only achieve by writing custom code.

The Developer Platform is only recommended for advanced developers who have experience creating custom websites, and have HTML, LESS CSS, JSON-T, and Git knowledge.

What can I customize with the Developer Platform?

After enabling Developer Mode, you can:

  • Create a custom 7.0 site template from scratch
  • Modify an existing 7.0 template
  • Access your template's markup, style sheets, scripts, and template design assets

You can’t:

  • Create or modify a custom 7.1 site
  • Access content added via the CMS
  • Add server-side custom code
  • Modify default scripts and styles
  • Modify existing editing tools
  • Customize blocks
  • Customize Cover Pages

To learn more, visit developers.squarespace.com.

How will my site change after enabling Developer Mode?

If your site still includes demo content, this content will disappear after enabling Developer Mode. Also:

  • You won't be able to switch templates.
  • Your template won't receive any template updates from Squarespace. Your site will still receive platform-wide updates.

Otherwise, there won’t be any changes to your live site until you update your code.

If you disable Developer Mode in the future, you may lose some of these changes if you made them while in Developer Mode:

  • Template changes
  • Site Styles changes
  • All content in sidebars, headers, or footers, if the template you migrate to doesn’t support them

What happens if I use Developer Mode during a trial?

The Developer Platform is a Premium feature. During a trial, you have full access to Developer Mode. Trial sites with Developer Mode enabled don't expire, giving you as much time as you need to build your custom Squarespace site.

When upgrading to paid service, choose the Website Business plan or higher to continue using Developer Mode.

If you choose the Personal Plan, we recommend turning Developer Mode off first. If you leave Developer Mode on, it stays on and prevents your site from receiving template updates, but you can't make further changes.

What happens if I use Developer Mode and then downgrade?

If you downgrade to the Personal Plan after activating Developer Mode:

  • The Developer Mode customizations you made to your site will remain.
  • Developer Mode will stay on, but you won't be able to make any further changes.
  • Because Developer Mode is still on, you won't receive template updates.
  • To regain access to Developer Mode, upgrade to the Website Business plan or higher.

Why can't I log in?

If you see an Authentication failed error when you try to log in, it may be because you've enabled two-factor authentication, or that you use social login. In either case, you'll need to create an app password to log in. Alternatively, you can disable two-factor authentication and/or switch your login method to email and password.

Can I contact Customer Support for help?

You can contact us with questions about enabling and getting started with the Squarespace Developer Platform. We can't help you write or troubleshoot custom code solutions, however, as these topics fall outside our scope of our support. For this reason, we only recommend the Developer Platform if you have advanced knowledge of coding languages and can troubleshoot code issues independently.

If you have questions about custom code, try these resources:

Was this article helpful?
107 out of 135 found this helpful
Squarespace Developer Platform FAQ