Squarespace Schema Implementation Problems & Solutions

🎯 Quick Fix Guide

Common Squarespace schema issues:

No product stars → Add custom aggregateRating via Code Injection
Missing FAQ schema → Use Code Injection to add FAQ markup
Incomplete blog schema → Fill ALL blog post settings (author, category, image)
Duplicate Organization schema → Check Code Injection for conflicts
Validate changes → Schema Validator

Squarespace is elegant. Beautiful templates. Smooth editing. Perfect for creatives, designers, and small businesses.

But like Wix, Squarespace is a closed platform. You get what they give you. And when it comes to schema markup? They give you the basics—but not the bells and whistles.

Here's how to work within Squarespace's limitations and maximize your schema potential.

What Schema Does Squarespace Provide?

Squarespace 7.1 (current version) auto-generates some schema. Here's what you get:

Built-in Squarespace Schema:

✓
Organization Schema:
Site name, logo, social profiles (from Business Info settings)
✓
Article Schema (Blog):
Headline, publish date, author, featured image, description
✓
Product Schema (Commerce):
Name, image, price, currency, availability, description
✓
WebSite Schema:
Basic site structure and search action

What's Missing:

✗
AggregateRating (Product Reviews):
Even with reviews enabled, star rating schema isn't added
✗
Breadcrumb Schema:
No automatic breadcrumb navigation schema
✗
FAQ Schema:
FAQ blocks don't generate schema markup
✗
Recipe Schema:
No support for recipe markup (food bloggers lose)
✗
HowTo Schema:
Tutorial content lacks structured steps markup
✗
VideoObject Schema:
Video embeds don't include structured video data

Problem #1: Product Reviews Without Star Ratings

Squarespace Commerce has product reviews built-in. Customers can leave reviews. But Google won't show stars because the schema lacks aggregateRating.

The Problem:

Squarespace's Product schema looks like this:

{
  "@type": "Product",
  "name": "Handmade Candle",
  "image": "...",
  "offers": {
    "@type": "Offer",
    "price": "24.99",
    "priceCurrency": "USD"
  }
  // Missing: aggregateRating
}

Solution: Add Custom AggregateRating

Calculate Your Rating:
Average rating = Total rating points ÷ Number of reviews
Example: (5+5+4+5+4) / 5 = 4.6
Go to Code Injection:
Settings → Advanced → Code Injection → Header

Add Schema:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Handmade Candle",
  "image": "https://yoursite.com/candle.jpg",
  "description": "Soy wax candle...",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "reviewCount": "23"
  },
  "offers": {
    "@type": "Offer",
    "price": "24.99",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}
</script>

Update Manually:
When new reviews come in, update ratingValue and reviewCount

Limitation:

This creates duplicate Product schema (yours + Squarespace's built-in). Generally safe, but could cause conflicts. Monitor in Schema Validator and Google Search Console.

Problem #2: FAQ Blocks Don't Generate Schema

Squarespace has beautiful FAQ accordion blocks. But they're just HTML—no schema.

Add FAQ Schema Manually:

Create your FAQ accordion block in Squarespace (visual design)
Go to Settings → Advanced → Code Injection → Page Header Settings (for specific page)
Add FAQ schema matching your accordion content:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What are your shipping times?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "We ship within 2-3 business days. Delivery takes 5-7 days domestically."
      }
    },
    {
      "@type": "Question",
      "name": "Do you offer international shipping?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes, we ship worldwide. International delivery takes 10-14 days."
      }
    }
  ]
}
</script>

Problem #3: Incomplete Blog Post Schema

Squarespace adds Article schema to blog posts, but it's only as good as the data you provide.

Optimize Blog Post Schema:

Featured Image (Required)

Every blog post MUST have a high-quality featured image. Squarespace uses this for schema image property. Minimum 1200x630px.

Author Profile (Important)

Set up author with name, bio, and profile photo in Squarespace. Incomplete profiles = incomplete schema.

Categories & Tags

Use categories and tags. Helps Google understand content context (though not directly in schema).

Post Description

Fill the SEO description for each post. Squarespace includes this in Article schema description field.

Problem #4: No Breadcrumb Schema

Breadcrumbs help Google understand site structure. Squarespace doesn't auto-generate this schema.

Add Breadcrumb Schema:

Use Code Injection (page-specific or site-wide):

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://yoursite.com"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog",
      "item": "https://yoursite.com/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Article Title"
    }
  ]
}
</script>

Adjust for each page type (product, blog, service, etc.)

Squarespace 7.0 vs 7.1 Schema Differences

Version Comparison:

7.0 (Legacy):

Minimal automatic schema. Most schema requires Code Injection. Less SEO-friendly.

7.1 (Current):

Better automatic schema (Organization, Article, Product, WebSite). Still missing advanced types.

Recommendation:

If on 7.0, migrate to 7.1 for better built-in schema support. Squarespace provides migration tools.

Common Squarespace Schema Mistakes

Mistake: Adding Schema Without Testing

You add custom schema via Code Injection but never validate it. Contains errors you don't notice.

Fix: Always test with Schema Validator after adding custom code.

Mistake: Duplicate Organization Schema

Squarespace adds Organization schema. You add another via Code Injection. Now you have two.

Fix: Don't manually add Organization schema—use Squarespace's Business Info settings instead.

Mistake: Missing Required Fields

Custom schema lacks required properties (image, description, etc.). Google rejects it.

Fix: Use complete schema templates. Check Google's schema requirements for each type.

Mistake: Not Updating Dynamic Data

Product price changed, but schema still shows old price. Reviews increased, but reviewCount stays at 5.

Fix: Set calendar reminders to update custom schema quarterly. Or consider WordPress for automatic updates.

When to Leave Squarespace

Consider Migration If:

•Food blogger needing Recipe schema extensively
•Tutorial site requiring HowTo schema for every page
•E-commerce with hundreds of products (manual schema updates impractical)
•SEO-heavy niche where competitors have advanced schema
•Need dynamic schema that auto-updates from database

Better platforms for schema: WordPress (full control), Shopify (e-commerce), Webflow (design + code flexibility)

Maximizing Squarespace Schema

Optimization Checklist:

Fill Business Info completely (Settings → Business Info)Every blog post has featured image (1200x630px minimum)Author profiles complete with bio and photoProducts have complete descriptions, pricing, imagesAdded FAQ schema via Code Injection (if using FAQ blocks)Added aggregateRating for products with reviewsValidated all custom schema with Schema ValidatorQuarterly calendar reminder to update custom schema

Frequently Asked Questions

Does Squarespace automatically add schema markup?

Yes, Squarespace 7.1 and newer add basic schema automatically: Organization (site-wide), Article (blog posts), Product (commerce pages). However, it's limited—missing FAQ, Recipe, HowTo, aggregateRating, and advanced features. You can add custom schema via Code Injection (Settings → Advanced → Code Injection → Header), but options are restricted.

Can I add custom schema to Squarespace without breaking the site?

Yes, using Code Injection is safe. Go to Settings → Advanced → Code Injection → Header section. Add JSON-LD schema in <script type='application/ld+json'> tags. This won't break your site, but: 1) Test with Schema Validator, 2) May conflict with Squarespace's auto schema, 3) Updates manually, not dynamic, 4) Limited to page header only. Make changes carefully and validate.

Why aren't product reviews showing star ratings on Squarespace?

Squarespace Commerce includes basic Product schema but doesn't add aggregateRating from reviews. Even with reviews enabled, the schema lacks rating data. Solutions: 1) Add custom aggregateRating via Code Injection (manual), 2) Use third-party review platform (Yotpo, Judge.me) with Squarespace integration, 3) Manually calculate and add ratings to each product page schema. No automatic solution exists.

Should I upgrade from Squarespace 7.0 to 7.1 for better schema?

Yes, if possible. Squarespace 7.1 has significantly better automatic schema support than 7.0. Benefits: Organization schema, improved Article schema, better Product schema, WebSite schema. Migration requires redesigning your site in 7.1 templates, but the SEO benefits (including schema) are worth it. Squarespace provides migration guides.

The Bottom Line

Squarespace gives you a solid foundation—Organization, Article, and Product schema work well out-of-the-box. But advanced features require manual Code Injection and ongoing maintenance.

For simple sites (portfolio, blog, small store), this is manageable. For complex sites with extensive schema needs, consider a more flexible platform.

Validate Squarespace Schema →Wix Schema Limitations →

Squarespace Schema Problems & How to Fix Them