How to Connect Your Squarespace site to SEOmatic

Written By Minh

Last updated About 1 month ago

Minimum Requirements

  • A Squarespace account with site owner or admin access

  • An Advanced plan (formerly Commerce Advanced)

  • A Squarespace site with at least one Store Page

Setting Up Your Squarespace API Key

Before connecting, you need to generate an API key in your Squarespace site settings.

  1. Log in to your Squarespace site.

  2. Go to Settings → Advanced → Developer API Keys.

  3. Click Generate Key.

  4. Name your key (e.g., "SEOmatic").

  5. Select the Products API with Read and Write permission.

  6. Click Next.

  7. Copy the generated API key — keep it secure, it is only shown once and cannot be retrieved later.

Step 1: Go to Connections

In your SEOmatic dashboard, go to Connections from the sidebar (or click the "Missing connection" warning in the header if you see one).

Step 2: Enter Your Credentials

Click Connect Squarespace and fill in your Site URL (e.g., yoursite.squarespace.com or your custom domain) and your API Key.

SEOmatic will automatically validate your credentials as you type. If the API key is valid, you'll see your site name appear.

Click Connect.

Step 3: You're Connected

On the Connections page, you should now see your Squarespace site listed with a green "active" status — that means you're connected and ready to publish.

Troubleshooting

Problem

Solution

Invalid API key

Double-check that you copied the full API key. Keys are only shown once when generated — if you lost it, generate a new one under Settings → Advanced → Developer API Keys.

Access denied

Make sure your API key has Products with Read and Write permission. Permissions can't be changed after creation — generate a new key with the correct permission.

Connection timed out

The Squarespace API took too long to respond. Try again in a few minutes.

Rate limit exceeded

Squarespace limits API requests to 300 per minute. Wait a few minutes and try again.

Plan not supported

The Squarespace Commerce API requires an Advanced plan (formerly Commerce Advanced). Check your plan under Settings → Site & Language → Site Availability.