AI is incredible for rapid idea and hypothesis testing by prototyping. It isn't about writing code — it’s about protecting your most valuable resource: cognitive energy. As engineers, we often face the overwhelming task of determining the look, feel, and architecture of an idea through hundreds of t...

We read reviews before buying a TV, a sweater, almost anything. Businesses do the same – potential enterprise partners evaluate APIs through every piece of content they come across. So, what happens when you improve all of it?

HTML video and audio lazy loading is now a web standard and quickly gaining support in all major browsers. Given Squarespace’s role in proposing and implementing it, we’re very excited to see how developers use it on the web. Let’s cover some best practices for using video and audio lazy loading in ...

At Squarespace, many of our core products are built on web standards, and our engineers are constantly pushing the boundaries of the web’s capabilities. Occasionally, those boundaries reveal a limitation: an opportunity for the web’s native capabilities to grow. This post is the story of how we foun...

In the fast-paced world of software development, documentation often gets a bad rap. It's perceived as a chore, a necessary evil, and sometimes, unfortunately, an afterthought. But what if writing documentation could be as dynamic and collaborative as writing the code itself? What if it could be sim...

Our teams love relational databases and the benefits ACID properties bring to us as engineers, but they have their limits, especially in horizontal scaling. We had to adopt new database tech across a fleet of highly available services while eliminating as much risk as possible… but how? Enter: chang...

On the Unfold team at Squarespace, our mobile releases don't require much in the way of manual intervention or human oversight. In fact, we don’t have to give releases much thought at all. But, this was not always true. This post is a look into what these non-eventful mobile releases are like, dig i...

Recently we introduced a write back cache to our Asset Library. This improvement makes life easier for both our customers and our developers. This post walks through the why, the why not and the how.

The outro recaps what you did – write technical documentation! – and introduces next steps like organizing a collection of documentation, revising existing content, and expanding your technical writing skills by joining the technical writing community.

After completing Parts 1, 2, and 3 of this tutorial, your once blank page now has technical writing – you're officially in the home stretch! Technical writing on a page becomes technical documentation only after you test, edit, and publish the content. Do not underestimate the exponential payoff tha...

In my opinion, creating good headings and organizing them in a way that’s helpful to readers is much more challenging than drafting content. So pat yourself on the back for completing Part 2 of this series and making it to Part 3. 👏 👏 👏 However, there are three things that undo exceptional headings ...

Part 1 of this tutorial introduced you to the content types that are most common in technical documentation. You also evaluated a real-life example as a reader, and you may have realized how headings are essential to a good reader experience. It’s because readers on the web do not read – they scan ¹...

In the same way the term “books” includes fiction, nonfiction, and biographies as genres, the term “technical documentation” includes many different content types. But what sets technical documentation apart from books are reader traits. These traits are a result of what the reader does as they read...

Writing is a learned skill. No one person is a good or bad writer. 🙂 When a colleague asked me to mentor them on technical writing, I searched for a single technical writing article, guide, book, or tutorial that addressed three key things. Since I couldn’t find one, I decided to create a tutorial o...

Last month we shipped the biggest change to our core website editing experience in ten years: Fluid Engine. This blog post addresses how we arrived at the implementation, in addition to walking through a few technical and user experience issues that were core to the development of this feature.

Imagine you are editing your Squarespace website on your desktop browser and you want to add great photos that make your site stand out. At that moment, you realize those great photos are actually on your phone. Wouldn’t it be great if you could cut out all the intermediate steps and directly access...

Recently, we introduced Background Art as a new way for customers to add graphics to their websites. This feature leverages WebGL to generate abstract animated graphics client side. These graphics can be seamlessly added to a web page, offering an alternative to images and videos for section backgro...

More so than any other level of the management chain, front-line engineering managers are the most attuned to the day to day realities of shipping software. Giving them a collective voice to surface what works and what doesn’t is critical to understanding the efficacy of organizational policy and pr...

“The Nuts and Bolts” is a reoccurring Q&A with Squarespace engineers. Questions are compiled by their peers to guarantee we get right to the good stuff.

How do you make a website look good when you can't know how that website will look? It turns out this is one of the fundamental questions we work with at Squarespace. Since one of our goals is to make it easy for our users to create beautiful websites, we need to walk a delicate balance between cons...

Squarespace's site builder allows our millions of customers to build their unique sites. The content within a given site, like text and buttons, live within small sections called blocks. Earlier this year, the Core Layout team addressed the largest shortcoming of the block editing experience: the bl...

As our suite of products has grown from a website builder and commerce tools to encompass much more, synchronizing frontend state across these products has become increasingly important. Complicating the matter, some products run in iframes, whereas others run in the main browser window. We’ve devel...

Mobile apps have complex state, view life cycle, callbacks, and other things that make testing hard. The web has been around a lot longer than mobile and enjoys the benefits of long-established tooling and practices for testing. Because the world of mobile testing is relatively new, it takes time an...

Developing great products isn’t just a matter of engineering; it’s also about developing an understanding of your users and their needs. A/B Testing is one of the most powerful tools in this regard, and over the past year, we’ve been turning A/B testing into a simple, repeatable process that scales ...