Skip to content
50% OFF $299 $599
Lock in
§ 2.5.4 ARTICLE

Image SEO · bulk alt text

Bulk alt text on Squarespace

Squarespace has no native bulk alt-text editor for regular Image Blocks as of Q2 20261. The only bulk path that ships with the platform is Commerce CSV export/import, which includes the SEO Description column2. For non-Commerce images on a site with 50, 500, or 2,000 images, the realistic workflow is a combination of pattern alt-text, batch editing, and — where it pays off — AI-assisted drafting with a human review pass.

The discipline scales with image count. Under 50 images: edit by hand. 50-500: pattern approach with batches. 500+: AI-assisted drafting plus pattern templates. The Commerce flow is the one exception where Squarespace ships a real bulk-edit path.

The honest state of bulk alt text in 2026

Squarespace ships per-image alt text through the Image Block Description field and through Commerce product images. There is no native bulk-edit screen for Image Block alt text. There is no API endpoint for setting alt text in bulk on regular blocks. There is no third-party plugin that genuinely automates the workflow without scraping the Squarespace editor — and scraping the editor is fragile across template updates. The only documented bulk path is the Commerce CSV export, which applies to product images but not to regular page or blog images.

What the platform supports

Commerce

supports CSV export with the SEO Description column. Edit in a spreadsheet, re-import, alt text updates.

Squarespace Help · 2026-Q1
Image Block

no bulk editor. Per-image only through the editor UI. The constraint that defines this workflow.

Squarespace Help · 2026-Q1
Gallery

per-image only. Each image in a gallery has its own Description field.

Squarespace Help · 2026-Q1

The CSV export-edit-paste workflow (Commerce only)

For Squarespace Commerce sites: open Settings > Commerce > Inventory. Click the three-dot menu, choose Export. Squarespace generates a CSV with one row per product variant. The columns include SEO Title, SEO Description, and Image Description — the SEO Description is the alt-text equivalent for product images. Edit the column in Excel, Numbers, or Google Sheets. Re-import. Squarespace applies the changes across the catalogue. Verified workflow as of Q2 2026.

csv Commerce product CSV — relevant alt-text column 
 Product Name,SKU,SEO Description,Image URL
Brass Pendant Light,BPL-001,Brass pendant light with linen shade in living room setting,...
Walnut Side Table,WST-002,Mid-century walnut side table with brass legs,...
Marble Coasters Set,MCS-003,Set of four marble coasters in geometric shapes,...

The CSV import respects existing data — empty cells in the import preserve current values, filled cells overwrite. This means you can run the bulk pass on just the SEO Description column without affecting product prices, inventory levels, or descriptions. For sites with 500+ products, the export-edit-import cycle takes ~30 minutes plus whatever time you spend writing alt text in the spreadsheet.

AI-assisted alt-text drafting

For high-volume cases — 500+ images on a non-Commerce site, or a photographer with a thousand-image catalogue — AI-assisted drafting is faster than writing alt text by hand. Gemini, Claude, and ChatGPT all support describing images from upload. The workflow: upload a batch of 10-20 images, ask the model to write alt text for each in a specific pattern, copy the output, paste back into Squarespace one image at a time. The human-review pass is non-negotiable — AI describes images plausibly but makes mistakes.

A useful pattern: ask the AI for the alt text in a JSON or CSV format so you can scan a batch of 20 outputs at once. Reviewing in tabular form catches the mistakes faster than reviewing one at a time in conversation form.

Ship the pattern, audit the outliers

For non-Commerce sites at any scale, the practical approach is a pattern + audit. Define a 1-line alt-text pattern for each image type: '[Service] [Detail] in [Location]' for a service business, '[Product] in [Style/Color]' for a portfolio, '[Subject] [Action] [Setting]' for a photographer. Apply the pattern in batches. Audit the outliers — the images that do not fit the pattern get individual attention. Google's documentation accepts templated alt text when it is accurate; the pattern is fine as long as each output describes the actual image.

Google's documentation3 is permissive on templates as long as the resulting text is accurate. The case to avoid is the same templated alt text on every image regardless of content — that is repetitive, not accurate, and downgrades the SEO value. A pattern that varies per image (different service, different detail, different location) is fine.

The audit step is what makes the pattern work. After applying alt text to a batch, spot-check 10-15 random images and verify the text matches what is actually in the image. Misapplied patterns (the same service name on photos that show different services) are caught here. The audit takes ~5 minutes per 100 images.

For sites where alt text is a recurring task (blogs, photographer portfolios with monthly new sessions), the pattern lives in a written brand-style document so anyone adding images can apply it. The cost of the discipline is low; the compounding value across hundreds of images is real.

Keep reading · § 2.5