Connect your Squarespace integration

Connect your Squarespace store and let Craftybase handle the inventory automatically

Managing your Squarespace shop and your Craftybase inventory separately means double-handling every sale. Connect the two and your stock levels update automatically as orders come in — no manual entry required.

Before you begin

  • You'll need an active Squarespace account with at least one published shop.
  • The connection uses OAuth — you'll be redirected to Squarespace to log in and authorise access. Craftybase only requests the minimum permissions needed to read your products and orders.
  • If you're on a trial account, you can pull up to one month of past order data. Subscribing removes this limit.

In this article:

Connecting your Squarespace account

  1. Go to Account Settings > Integrations.
  2. Locate the Squarespace section and click the Connect button.

  1. You'll be redirected to Squarespace. Enter your Squarespace login credentials and click Log in.

  1. Once authenticated, you'll be returned to your Integrations page. Your Squarespace shop will now appear in the list of connected integrations.

Craftybase only requests the minimum access needed to read your products and orders. You can revoke this access from your Squarespace account settings at any time.

We recommend creating your products in Squarespace first, then pulling them into Craftybase. This keeps your external references correct from the start.

Pulling your data

Once connected, Craftybase will automatically pull your Squarespace data on a scheduled basis.

  • Your first scheduled data pull will run at approximately 5 am in your account's time zone.
  • To pull data sooner, go to your Integrations page, locate your Squarespace shop, and click Pull Now →. Select the date range you'd like to pull and click Pull Data →.

Trial accounts can pull up to one month of past data. To backdate your pull further, subscribe to a paid plan.

What gets pulled from Squarespace

Products

the app pulls your physical products from Squarespace and creates them as products and listings in Craftybase. It's recommended to create your products in Squarespace first and then pull them into Craftybase — this keeps your external references correct from the start.

Only physical products are supported. Services, gift cards, and digital/download products are not pulled into the app at this time.

Variants

Squarespace variants are pulled as variation attributes and variations in Craftybase. Each variant's name, SKU, and price are mapped to a variation in the app.

Orders

Orders are pulled based on the date range you select when running a manual pull, or automatically during your daily scheduled pull. Order data is pulled based on the modified date of each order within your selected date range.

For each order, the app pulls:

  • Line items — product, quantity, and unit price paid
  • Shipping — shipping charged on the order, proportionally allocated across line items
  • Discounts — any discount applied, proportionally allocated across line items
  • Tax — tax charged, proportionally allocated across line items
  • Processing fees — payment gateway processing fees are recorded as expenses in the app

If an order was placed in a different currency to your account, amounts are automatically converted using the exchange rate at the time of the order.

Customers

A contact is created in Craftybase for each Squarespace customer, based on their billing email address.

FAQ

In this section:

Why aren't some of my Squarespace products appearing?

the app currently pulls physical products only. Services, gift cards, and digital/download products are not imported. If support for these product types would be useful for your workflow, contact our Support team — we'll add you to our list and follow up when this changes.

What do I do if my Squarespace connection stops working?

Squarespace uses a token-based connection that can expire. If your integration shows as inactive or your data is no longer pulling:

  1. Go to Account Settings > Integrations.
  2. Locate your Squarespace shop and check its status.
  3. If it shows as inactive, disconnect and reconnect the integration by following the steps in the Connecting your Squarespace account section above.

Need more help?

Here are some related articles that might be useful:

  • About integration data pulling — how scheduled and manual pulls work
  • Add or remove an integration — connecting and disconnecting integrations in the app
  • Integration troubleshooting — common issues with integration connections and data pulls

Still need help? Contact our support team and we'll be happy to assist.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.