If you have a Squarespace website, you can automatically sync your Art Galleria to it, instead of doing it manually.
Before you start
Please ensure that your current Squarespace plan is Advanced Commerce. This is a requirement for the sync service in order to be able to access the API features on Squarespace.
 |
This article covers how to:
Watch the video demonstration, or scroll down for step-by-step instructions.
Step 1: Generate the API key in Squarespace
1. Open your Squarespace dashboard. On the left menu select Settings > Advanced > Developer API Keys:
2. Click Generate Key.
3. Enter a name for the key and select all of the following: Products, Read and Write, Inventory and Read and Write.
4. Click Generate Key.
5. Click Copy Key. You will need to paste the key into the Art Galleria Webservice.
Step 2: Set up the integration in Art Galleria
1. In Art Galleria, open the Websites tab, click Webservices and click New Webservice.
2. In the New Web Service page:
Webservice Type: Select Squarespace
API Key: Paste in the API key that you generated earlier
Product Page: Select the appropriate Product Page, which will appear after you paste the API key.
Default Unit: Select the default unit, which must be the same units that are used on your Squarespace website.
Artwork Collections: Select the artwork collections you want to sync with Squarespace.
3. Click Create Webservice:
4. To sync your inventory, you have two options:
(A) Run a manual sync (this is only recommended for the first time you sync). To do this, click the more options (...) icon next to the webservice, and select Sync.
(B) Enable the scheduled sync. You can do this when setting up the webservice, or edit it afterwords to enable this option.
5. Once the sync has successfully completed, you can confirm that the artworks are available in your Squarespace site by going to your Squarespace admin console > Commerce > Inventory > All Products.
Step 3: Display artworks on your Squarespace website
Squarespace offers different options for displaying your inventory. After connecting to Squarespace and confirming your artworks have synced by checking the All Products section, you can then configure how they will display.
Squarespace has help content on this topic. You may find the following information useful:
Using Tags
All artworks are synced with the following information, stored as Product Tags:
Collection name
Artist name
You can view the tags attached to the products, by navigating to Products & Services, locating your artwork, and clicking Edit:
And scrolling down:
Using categories
Categories in Squarespace organize products into broad groups for navigation, while tags add specific details for filtering and search. Each serve a different purpose in how content is structured and discovered.
Since your synced artworks are automatically tagged with their respective collection and artist name, you can immediately use these tags alongside categories to create refined navigation, filtered product views, and targeted showcase pages without additional setup.
Ways to use Squarespace categories
Create Category-Based Pages with Tag Filters
Build a separate page for each main category (e.g. Paintings, Sculpture) using a Product Block filtered by that category, and enable tag filtering within the block so users can refine results by style, size, year, etc.
Use Tags for Cross-Category Highlights
Apply consistent tags like "New Arrival", "On Sale", or "Limited Edition" across multiple categories, then use Product Blocks filtered by those tags to create special landing pages or homepage sections that pull from various categories.
Improve On-Site Search and SEO
Use categories to define the main content structure for menus and navigation, and add detailed tags (e.g. "Abstract", "Coastal", "Neutral Tones") to improve keyword relevance for search, making it easier for users and search engines to find specific types of products.
Troubleshooting
None of the artworks are syncing to Squarespace.
None of the artworks are syncing to Squarespace.
Your Squarespace site has the Squarespace Advanced Commerce plan.
Your Squarespace site’s measurement standards (Metric or Imperial) match your selected option in the Webservice Sync Settings in Art Galleria. If they don't match you can edit the webservice in Art Galleria to change your settings, or adjust the selection in Squarespace > Settings > Language & Region > Measurement Standard.
Specific artworks do not appear in Squarespace.
Artworks will not be published if:
They are marked private or in Details Pending
They are archived
The associated artist profile is archived
The retail price is missing (not provided)
Specific artworks do not appear in Squarespace.
Specific artworks do not appear in Squarespace.
Artworks will not be published if:
They are marked private or in Details Pending
They are archived
The associated artist profile is archived
The retail price is missing (not provided)
I want my custom fields to sync to my site.
I want my custom fields to sync to my site.
Historically, integrating custom fields with Squarespace websites has been limited. However, we've recently developed a workflow that enables us to transfer specific custom fields directly into the artwork description displayed on Squarespace.
Contact Us, and let us know which fields you'd like to sync, or describe the specific outcomes you're aiming to achieve. We can then configure these fields to push seamlessly to your Squarespace site, ensuring they appear in the artwork description exactly as needed.
My artworks are being visually cut off after syncing and displaying on my website.
My artworks are being visually cut off after syncing and displaying on my website.
Please check your product image aspect ratio settings in Design > Site Styles, and adjust to suit your requirements.
I am trying to organize my synced artworks using tags, but I'm not able to.
I am trying to organize my synced artworks using tags, but I'm not able to.
Check your:
Theme - Some themes do not allow for product filtering using tags
Current Squarespace verssion - Squarespace 7.1 handles tags better than 7.0 by standardizing content types and removing template limitations, making it easier to use tags consistently across blog, product, and event collections.
FAQ
Q: How can I adjust how my synced artwork titles are displayed on my website?
Q: How can I adjust how my synced artwork titles are displayed on my website?
A: The default field display is Artist Name + Artwork Title. If you wish to change this, you can select one of the following options, and contact us to apply it.
Option #2 - Artwork title + Artwork year.
Option #3 - Artwork title.
Q: When syncing artworks to Squarespace, can I sync them to different locations?
Q: When syncing artworks to Squarespace, can I sync them to different locations?
A: No, at the moment artworks can only be synced to your designated Shop page, in Squarespace.