ecommerce-seo

Installation
SKILL.md

E-commerce SEO

Overview

E-commerce SEO covers the technical and content foundations that help search engines understand and rank your product pages: meta tags, structured data (JSON-LD), canonical URLs, XML sitemaps, and Core Web Vitals. Shopify and WooCommerce handle most technical SEO automatically; your effort should focus on optimizing titles, descriptions, and structured data quality — not plumbing.

When to Use This Skill

  • When building product pages that need to rank in Google Shopping and organic search
  • When implementing JSON-LD structured data for rich snippets (price, availability, reviews)
  • When handling canonical URLs for products with multiple variants or filter combinations
  • When generating XML sitemaps for a large catalog (10K+ products)
  • When diagnosing why products are not appearing in Google Shopping rich results

Core Instructions

Step 1: Check what your platform handles automatically

Before installing anything, understand what is already built in:

Feature Shopify WooCommerce BigCommerce
XML sitemap Auto-generated at /sitemap.xml Auto-generated at /sitemap_index.xml (with Yoast SEO) Auto-generated at /xmlsitemap.xml
Canonical URLs Yes (built-in) Yes (with Yoast SEO) Yes (built-in)
Meta title/description editing Yes (via product editor) Yes (via Yoast SEO fields) Yes (via product editor)
JSON-LD product schema Basic (varies by theme) Requires WooCommerce + Yoast or Rank Math Basic (varies by theme)
robots.txt Editable in Online Store settings Editable via file or Yoast Editable via admin

Step 2: Install an SEO foundation


Shopify

Shopify handles sitemaps, canonicals, and basic schema automatically. Focus on:

  1. Install a SEO app for enhanced structured data and bulk editing:
    • Yoast SEO for Shopify ($19/mo) — most comprehensive
    • Schema Plus (free tier) — focused on JSON-LD structured data
    • SEO Manager ($20/mo) — bulk meta editing + structured data
  2. Go to Shopify Admin → Online Store → Preferences and verify:
    • Your homepage title and meta description are set
    • Google Analytics is connected
  3. Go to each product's page in admin and fill in the SEO section at the bottom:
    • Write unique meta titles following: [Brand] [Product Name] - [Key Attribute] | [Store Name]
    • Write unique meta descriptions (150–160 characters) that include price range, key benefit, and a call to action
  4. Submit your sitemap to Google Search Console: go to search.google.com/search-console → Sitemaps → Add yourstore.com/sitemap.xml

WooCommerce

  1. Install Yoast SEO (free) or Rank Math (free) from the WordPress plugin directory — these are required for proper WooCommerce SEO
  2. After installing Yoast SEO:
    • Go to Yoast SEO → Search Appearance → WooCommerce and configure product page templates
    • Enable JSON-LD structured data under Yoast SEO → Search Appearance → Schema
    • Go to Yoast SEO → Tools → Bulk Editor to edit meta titles and descriptions for all products at once
  3. For enhanced product schema (price, availability, reviews):
    • Install Rank Math which includes WooCommerce Product Schema with review aggregation built in
  4. Submit sitemap to Google Search Console: Yoast auto-generates /sitemap_index.xml

BigCommerce

  1. BigCommerce includes basic SEO features built-in. Go to BigCommerce Admin → Products → [Edit Product] → SEO tab
  2. For enhanced structured data: install SEO Expert from the BigCommerce App Marketplace
  3. Go to Store Setup → Search Engine Optimization to configure global defaults
  4. Submit your sitemap at yourstore.com/xmlsitemap.xml to Google Search Console

Custom / Headless

For headless storefronts, implement structured data manually. Serve JSON-LD on every product page:

function buildProductJsonLd(product: Product, reviews: ReviewSummary) {
  return {
    '@context': 'https://schema.org',
    '@type': 'Product',
    name: product.title,
    image: product.images.map(img => img.src),
    description: product.metaDescription || product.description.slice(0, 200),
    sku: product.variants[0]?.sku,
    brand: { '@type': 'Brand', name: product.vendor },
    offers: product.variants.length === 1
      ? {
          '@type': 'Offer',
          url: `https://yourstore.com/products/${product.slug}`,
          priceCurrency: 'USD',
          price: (product.variants[0].priceInCents / 100).toFixed(2),
          availability: product.variants[0].inventoryQuantity > 0
            ? 'https://schema.org/InStock'
            : 'https://schema.org/OutOfStock',
        }
      : {
          '@type': 'AggregateOffer',
          lowPrice: (Math.min(...product.variants.map(v => v.priceInCents)) / 100).toFixed(2),
          highPrice: (Math.max(...product.variants.map(v => v.priceInCents)) / 100).toFixed(2),
          priceCurrency: 'USD',
          offerCount: product.variants.length,
        },
    ...(reviews.count > 0 ? {
      aggregateRating: {
        '@type': 'AggregateRating',
        ratingValue: reviews.average.toFixed(1),
        reviewCount: reviews.count,
        bestRating: '5',
      },
    } : {}),
  };
}

For canonical URL handling on variant pages — strip variant parameters:

// Always use the base product URL as canonical
// /products/blue-widget?variant=123 → canonical: /products/blue-widget
function getCanonicalUrl(path: string): string {
  // Strip variant query parameters
  return `https://yourstore.com${path.split('?')[0]}`;
}

For large catalogs (10k+ products), use a sitemap index:

// Serve /sitemap.xml as a sitemap index pointing to paginated product sitemaps
// Each child sitemap: max 50,000 URLs
// Regenerate every 6 hours or on product publish/unpublish events

Step 3: Optimize product titles and descriptions

This is the highest-ROI SEO work. Follow these title formats:

  • Product title format: [Brand] [Product Name] [Key Attribute] - [Store Name]
    • Example: "Nike Air Max 90 White - Running Store"
  • Meta description format: Include price range, key benefit, and CTA in 150–160 characters
    • Example: "Shop Nike Air Max 90 from $120. Lightweight cushioning for daily runs. Free shipping on orders over $75. Shop now."

Common issues to fix:

  • Duplicate meta titles across variants (fix: add variant-specific attributes to the title)
  • Meta descriptions that are just the product description truncated (fix: write purposeful descriptions)
  • Missing alt text on product images (fix: use [Product Name] - [Color/View] format)

Step 4: Handle technical SEO issues

Canonical URLs for filter pages:

  • Collection pages with active filters (/collections/shoes?color=red) should use self-referencing canonicals
  • Pages with sort order only (/collections/shoes?sort=price-asc) should canonical back to the unfiltered collection URL

In Shopify, this is handled automatically. In WooCommerce with Yoast, go to Yoast SEO → Search Appearance → Taxonomies and configure canonical behavior for filtered pages.

Robots.txt — block these paths:

  • /cart and /checkout — not indexable
  • /account and /search? — not indexable
  • Collection filter combinations with 3+ active filters — use noindex, follow meta tag

In Shopify: Online Store → Themes → Edit Code → robots.txt.liquid In WooCommerce: Yoast SEO manages robots.txt automatically

Step 5: Verify with Google tools

  1. Google Rich Results Test (search.google.com/test/rich-results): paste any product URL and verify structured data is correct
  2. Google Search Console: check for structured data errors under Enhancements → Products
  3. PageSpeed Insights: test Core Web Vitals — target LCP under 2.5 seconds, CLS under 0.1

Best Practices

  • Write unique meta descriptions for every product — avoid duplicating the product title; include key attributes (size, material, price) that help click-through rate
  • Compress and properly size product images — oversized images are the #1 cause of slow LCP scores; Shopify compresses automatically; WooCommerce use ShortPixel or Imagify plugin
  • Use JSON-LD over microdata — easier to maintain and Google recommends it
  • Set canonical URLs on every page — self-referencing canonicals prevent duplicate content from URL parameters
  • Update sitemaps automatically — Shopify and WooCommerce + Yoast do this; for custom builds, regenerate on product publish/unpublish events
  • Add image sitemaps — include product images with descriptive alt text for Google Image search traffic

Common Pitfalls

Problem Solution
Products not appearing in Google Shopping rich results Check Google Search Console → Enhancements → Products for structured data errors; use Rich Results Test to validate
Faceted navigation creating millions of indexable URLs Shopify/WooCommerce handle this automatically with canonicals; for custom builds, use noindex, follow on heavily filtered pages
Out-of-stock products returning 404 Keep the page live at 200 status; show "out of stock" and suggest alternatives; remove from sitemap only if permanently discontinued
Schema.org validation errors Test with Google's Rich Results Test; ensure price and availability are always present and correctly formatted
Slow Core Web Vitals hurting ranking Preload hero images, compress product images, use lazy loading below fold; Shopify's CDN helps significantly

Related Skills

  • @google-shopping-feed
  • @google-ads-ecommerce
  • @content-commerce
  • @social-proof-widgets
Weekly Installs
22
GitHub Stars
14
First Seen
Mar 16, 2026
Installed on
github-copilot21
gemini-cli21
cursor21
opencode21
amp21
cline21