SEO Plugin Compatibility
Commerce Connect is compatible with all major WordPress® SEO plugins including Yoast SEO, Rank Math, All in One SEO, SEOPress, and The SEO Framework.
Why SEO Plugins Work with Commerce Connect
Section titled “Why SEO Plugins Work with Commerce Connect”Critical value proposition: Commerce Connect products are synced from BigCommerce but live as real WordPress® pages with proper URLs, meta tags, and structured data. They’re not iframes or external embeds—they’re native WordPress® content.
This architectural decision means:
- Search engines index your products as WordPress® content, not BigCommerce content
- WordPress® SEO plugins work out of the box with your product catalog
- You get the best of both worlds: BigCommerce catalog management + WordPress® SEO power
The SEO Advantage
Section titled “The SEO Advantage”When you use Commerce Connect with Yoast SEO:
- Native WordPress® SEO - Products rank like blog posts or pages (Google sees them as WordPress®)
- Granular control per product - Set unique meta descriptions, focus keyphrases, and search appearance for each SKU
- Rich snippets - Schema.org Product markup for enhanced search results (price, availability, ratings)
- Social optimization - Control how products appear when shared on Facebook, Twitter, LinkedIn
- Real-time optimization - Edit SEO metadata without touching BigCommerce or waiting for sync
This matters for product discovery. SEO is critical for driving organic traffic to your products. Commerce Connect gives you enterprise catalog management (BigCommerce) with best-in-class SEO tools (WordPress®/Yoast).
Key Concept: The Two-Layer Architecture
Section titled “Key Concept: The Two-Layer Architecture”Understanding this architecture is critical to using Yoast effectively with Commerce Connect:
Layer 1: Product Data (BigCommerce)
Section titled “Layer 1: Product Data (BigCommerce)”- Product title, description, price, inventory, images
- Managed in BigCommerce admin
- Syncs to WordPress® via API/webhook
- Read-only in WordPress® (prevents conflicts)
Layer 2: SEO Metadata (WordPress®)
Section titled “Layer 2: SEO Metadata (WordPress®)”- Focus keyphrase, meta description, search appearance
- Social sharing previews, schema markup
- Managed in WordPress® via Yoast SEO
- NOT synced back to BigCommerce
- Stored as WordPress® post meta
Why this matters: You can optimize how products appear in search results without touching the product catalog. Marketing team can improve SEO while catalog team manages inventory—no conflicts.
Workflow summary:
- Edit product catalog in BigCommerce (title, description, price, images)
- Edit SEO metadata in WordPress® (meta description, focus keyphrase, search preview)
- Both layers combine to create the final product page that Google indexes
Prerequisites
Section titled “Prerequisites”- Commerce Connect plugin installed and configured
- Products synced from BigCommerce (visible in Commerce Connect > Products)
- Yoast SEO plugin installed (free or premium version)
Installing Yoast SEO
Section titled “Installing Yoast SEO”Via WordPress® Admin:
- Go to Plugins > Add New
- Search for “Yoast SEO”
- Click Install Now > Activate
Or install Yoast SEO Premium:
- Download from your Yoast.com account
- Upload via Plugins > Add New > Upload Plugin
- Activate and enter license key
Enabling Product Support
Section titled “Enabling Product Support”Yoast SEO automatically detects the product post type created by Commerce Connect. No additional configuration needed.
To verify products are enabled:
- Go to WordPress® Admin > SEO > Search Appearance
- Click the Content Types tab
- Confirm Products is listed
- Ensure “Show Products in search results” is set to Yes
- Click Save Changes
If products don’t appear in the list: Make sure Commerce Connect is installed and at least one product has been synced from BigCommerce.
Complete Workflow: Adding SEO to a Product
Section titled “Complete Workflow: Adding SEO to a Product”This is the workflow demonstrated in Commerce Connect demos—the “Edit in WordPress®” path that unlocks WordPress® plugin functionality.
Step 1: Navigate to Products
Section titled “Step 1: Navigate to Products”- Go to WordPress® Admin > Commerce Connect > Products
- You’ll see your product list synced from BigCommerce
- Find the product you want to optimize for search
Step 2: Choose “Edit in WordPress®” (NOT “Edit in BigCommerce”)
Section titled “Step 2: Choose “Edit in WordPress®” (NOT “Edit in BigCommerce”)”- Click “Edit in WordPress®” for the product
- Critical distinction: “Edit in BigCommerce” takes you to catalog management; “Edit in WordPress®” unlocks SEO and WordPress® plugins
- The product edit screen opens in WordPress®
Step 3: Understanding What’s Editable vs. Read-Only
Section titled “Step 3: Understanding What’s Editable vs. Read-Only”What you’ll see on the product edit screen:
Read-Only (Grayed Out):
- Product title
- Product description
- Price
- Inventory/stock status
- Product images
- Product categories (from BigCommerce)
Why are these read-only? BigCommerce is the source of truth for product catalog data. Making these editable in WordPress® would create sync conflicts—which system wins? By keeping BigCommerce as the single source of truth for product data, you avoid data inconsistencies.
If you need to edit these fields:
- Click the “Edit in BigCommerce” button at the top of the WordPress® editor
- Make changes in BigCommerce (price, description, inventory, images)
- Changes sync to WordPress® automatically via webhook (usually instant)
Fully Editable (WordPress®-Managed):
- Yoast SEO metadata (focus keyphrase, meta description, search appearance)
- Custom fields (via ACF or other plugins)
- Any WordPress® plugin meta boxes that extend product pages
This separation is the key architectural benefit:
- BigCommerce = Product catalog management (what you’re selling)
- WordPress® + Yoast = SEO optimization layer (how you rank)
Step 4: Scroll to Yoast SEO Panel
Section titled “Step 4: Scroll to Yoast SEO Panel”- Scroll down below the grayed-out product data
- You’ll see the Yoast SEO meta box (same panel you’d see on blog posts or pages)
- This is where you optimize the product for search engines
Step 5: Set Your Focus Keyphrase
Section titled “Step 5: Set Your Focus Keyphrase”- In the Yoast SEO panel, find the Focus keyphrase field
- Enter the primary keyword/phrase you want this product to rank for
- Example: “organic cotton throw blanket” or “linen duvet cover queen”
- Yoast analyzes the product content (synced from BigCommerce) and shows SEO score:
- ✅ Keyphrase in title
- ✅ Keyphrase in description
- ⚠️ Keyphrase density too low
- ❌ No images with keyphrase in alt text
Key insight: Yoast reads the product title and description from BigCommerce. If your focus keyphrase isn’t in the BigCommerce description, Yoast will flag it. Update the product description in BigCommerce to improve the score.
Step 6: Customize Meta Description
Section titled “Step 6: Customize Meta Description”- In Yoast SEO panel, click “Edit snippet”
- Find the Meta description field
- Write a search-optimized description (under 160 characters)
- Include focus keyphrase naturally
- Highlight product benefits
- Add call to action or unique selling point
- Preview Google search result - See exactly how your product will appear in search
Example:
- BigCommerce description (first 160 chars): “Crafted from 100% European flax linen, this duvet cover brings breathable luxury to your bedroom. Natural temperature regulation…”
- Optimized meta description (Yoast): “Luxury linen duvet cover - 100% European flax. Breathable, naturally temperature-regulating. King, Queen, Full sizes. Free shipping over $100.”
Why better? Includes sizes, mentions shipping benefit, more action-oriented.
Step 7: Review Search Appearance
Section titled “Step 7: Review Search Appearance”- In the Yoast snippet preview, check:
- SEO title - Defaults to
[Product Title] - [Site Name] - URL - The WordPress® product permalink
- Meta description - Your custom version or auto-generated from description
- SEO title - Defaults to
- Customize SEO title if needed (click “Edit snippet” > modify “SEO title” field)
- Keep under 60 characters to avoid truncation
- Example: “Organic Cotton Throw Blanket - Sustainable Bedding | Line & Loom”
Step 8: Save Changes
Section titled “Step 8: Save Changes”- Click “Update” to save the product
- SEO metadata is stored in WordPress® (not synced back to BigCommerce)
- Product data remains unchanged in BigCommerce
Result: You’ve added a WordPress® SEO layer on top of BigCommerce product data—without touching the product catalog itself.
Step 9: Validate on Live Site
Section titled “Step 9: Validate on Live Site”- Visit the product page on your live site
- Right-click > View Page Source
- Search for:
<meta name="description"- Your custom meta descriptionapplication/ld+json- Schema.org Product markup (added by Yoast automatically)
- Verify meta description displays correctly in source
Step 10: Monitor Performance
Section titled “Step 10: Monitor Performance”- Add product URL to Google Search Console
- Track impressions, clicks, average position over time
- Refine meta description based on click-through rate (CTR)
- Use Google Rich Results Test to validate schema markup
Quick Reference: What’s Editable Where
Section titled “Quick Reference: What’s Editable Where”| Field | Edit in BigCommerce | Edit in WordPress® (Yoast) |
|---|---|---|
| Product title | ✅ Yes | ❌ No (read-only) |
| Product description | ✅ Yes | ❌ No (read-only) |
| Price | ✅ Yes | ❌ No (read-only) |
| Inventory/stock | ✅ Yes | ❌ No (read-only) |
| Product images | ✅ Yes | ❌ No (read-only) |
| Product categories | ✅ Yes | ❌ No (read-only) |
| Focus keyphrase | ❌ No | ✅ Yes (Yoast SEO panel) |
| Meta description | ❌ No | ✅ Yes (Yoast SEO panel) |
| SEO title | ❌ No | ✅ Yes (Yoast SEO panel) |
| Search appearance preview | ❌ No | ✅ Yes (Yoast SEO panel) |
| Social sharing image | ❌ No | ✅ Yes (Yoast Social tab) |
| Schema.org markup | ❌ No | ✅ Yes (auto-generated by Yoast) |
| Custom fields (ACF) | ❌ No | ✅ Yes (if ACF installed) |
Key takeaway: BigCommerce = product catalog. WordPress® = SEO + extensions.
Use Cases
Section titled “Use Cases”Focus Keyphrase Optimization
Section titled “Focus Keyphrase Optimization”The focus keyphrase tells Yoast what keyword you’re targeting for this product.
Example: Organic Cotton Throw Blanket
Section titled “Example: Organic Cotton Throw Blanket”- In the Yoast SEO panel, enter focus keyphrase:
organic cotton throw blanket - Yoast analyzes the product title and description (synced from BigCommerce)
- Shows SEO score and recommendations:
- ✅ Keyphrase in title
- ✅ Keyphrase in description
- ⚠️ Keyphrase density too low - consider adding to BigCommerce description
- ❌ No images with keyphrase in alt text - update in BigCommerce
Key insight: Yoast analyzes your BigCommerce content and tells you what to improve there.
Custom Meta Descriptions
Section titled “Custom Meta Descriptions”Override the default meta description (auto-generated from product description) with a search-optimized version.
Example: Linen Duvet Cover
Section titled “Example: Linen Duvet Cover”BigCommerce Description (first 160 chars):
“Crafted from 100% European flax linen, this duvet cover brings breathable luxury to your bedroom. Natural temperature regulation keeps you cool in summer, warm in winter.”
Optimized Meta Description (via Yoast):
“Luxury linen duvet cover - 100% European flax. Breathable, naturally temperature-regulating. King, Queen, Full sizes. Free shipping over $100.”
Why better?
- Includes key product attributes (sizes)
- Mentions shipping benefit
- More action-oriented
- Still under 160 characters
How to set:
- In Yoast SEO panel, click Edit snippet
- Find Meta description field
- Enter your optimized description
- Preview shows how it looks in Google search results
- Click Save (closes snippet editor)
- Update the product
Search Appearance Preview
Section titled “Search Appearance Preview”Yoast shows exactly how your product will appear in Google search results.
What you see:
- Title tag - Defaults to Product Title + Site Name
- URL - The WordPress® product permalink
- Meta description - Auto-generated or your custom version
Customizing the title tag:
By default, Yoast uses this format:
[Product Title] - [Site Name]To customize for a specific product:
- Click Edit snippet
- Modify the SEO title field
- Example: “Organic Cotton Throw Blanket - Sustainable Bedding | Line & Loom”
- Keep under 60 characters to avoid truncation
Schema.org Product Markup
Section titled “Schema.org Product Markup”Yoast automatically adds structured data (schema.org/Product) to your product pages. This enables rich snippets in search results:
- Product name
- Price
- Availability
- Ratings (if using product reviews)
- Brand
- Images
Viewing the schema output:
- Visit a product page on your live site
- View page source (right-click > View Page Source)
- Search for
application/ld+json - You’ll see JSON structured data like:
{ "@context": "https://schema.org/", "@type": "Product", "name": "Organic Cotton Throw Blanket", "image": "https://yoursite.com/product-image.jpg", "description": "Crafted from 100% organic cotton...", "brand": { "@type": "Brand", "name": "Line & Loom" }, "offers": { "@type": "Offer", "url": "https://yoursite.com/products/organic-cotton-throw", "priceCurrency": "USD", "price": "89.00", "availability": "https://schema.org/InStock" }}How this helps:
- Google may show price and availability in search results
- Rich snippets increase click-through rate
- Product data feeds into Google Shopping (if configured)
Social Media Preview
Section titled “Social Media Preview”Control how products look when shared on Facebook, Twitter, LinkedIn.
Accessing social settings:
- In Yoast SEO panel, click the Social tab
- Facebook section:
- Upload custom image (overrides product image from BigCommerce)
- Set custom title and description for social shares
- Twitter section:
- Choose card type (Summary or Summary with Large Image)
- Set custom title and description
Example use case:
Your product has a white-background product shot in BigCommerce (good for ecommerce). For social shares, you want a lifestyle image showing the product in use.
- Upload lifestyle image in Yoast Facebook section
- When someone shares the product on Facebook, they see the lifestyle shot
- When someone views the product page, they see the standard product images from BigCommerce
Code Examples
Section titled “Code Examples”Programmatically Set Focus Keyphrase
Section titled “Programmatically Set Focus Keyphrase”Bulk-set focus keyphrases based on product title:
<?php// Set focus keyphrase for all productsfunction set_product_focus_keyphrases() { $products = get_posts(array( 'post_type' => 'product', 'posts_per_page' => -1, ));
foreach ($products as $product) { // Use product title as focus keyphrase $keyphrase = strtolower($product->post_title);
// Update Yoast meta update_post_meta($product->ID, '_yoast_wpseo_focuskw', $keyphrase); }}
// Run once via wp-cli or admin action// wp eval-file set-keyphrases.phpCustom Meta Description Template
Section titled “Custom Meta Description Template”Auto-generate meta descriptions from product attributes:
<?php// Generate meta description from product datafunction generate_product_meta_description($product_id) { $product = get_post($product_id); $price = get_post_meta($product_id, '_price', true);
// Get first 100 chars of description $excerpt = wp_trim_words($product->post_content, 15, '...');
// Build meta description $meta = sprintf( '%s - $%s. %s Shop now at %s.', $product->post_title, $price, $excerpt, get_bloginfo('name') );
// Truncate to 160 chars $meta = substr($meta, 0, 160);
// Update Yoast meta update_post_meta($product_id, '_yoast_wpseo_metadesc', $meta);
return $meta;}
// Hook into product syncadd_action('wpe_commerce_product_synced', 'generate_product_meta_description', 10, 1);Override Schema Output
Section titled “Override Schema Output”Add custom schema properties not included by default:
<?php// Add GTIN (barcode) to product schemaadd_filter('wpseo_schema_graph_pieces', function($pieces, $context) { if ($context->post && $context->post->post_type === 'product') { foreach ($pieces as &$piece) { if ($piece instanceof Yoast\WP\SEO\Generators\Schema\Product) { $gtin = get_post_meta($context->post->ID, '_gtin', true); if ($gtin) { $piece['gtin'] = $gtin; } } } } return $pieces;}, 10, 2);Bulk Update SEO Titles
Section titled “Bulk Update SEO Titles”Set consistent SEO title format across all products:
<?php// Set SEO title template for all productsfunction bulk_update_product_seo_titles() { $products = get_posts(array( 'post_type' => 'product', 'posts_per_page' => -1, ));
foreach ($products as $product) { $title = sprintf( '%s | Premium %s | %s', $product->post_title, 'Sustainable Goods', // Your category/brand get_bloginfo('name') );
// Update Yoast SEO title update_post_meta($product->ID, '_yoast_wpseo_title', $title); }}Add Custom Breadcrumbs
Section titled “Add Custom Breadcrumbs”Yoast supports breadcrumb customization for products:
<?php// Customize product breadcrumbsadd_filter('wpseo_breadcrumb_links', function($links) { global $post;
if ($post && $post->post_type === 'product') { // Get product category $terms = wp_get_post_terms($post->ID, 'product_category');
if ($terms && !is_wp_error($terms)) { $category = $terms[0];
// Insert category before product array_splice($links, -1, 0, array( array( 'url' => get_term_link($category), 'text' => $category->name, ) )); } }
return $links;});Troubleshooting
Section titled “Troubleshooting”Yoast SEO panel not appearing in product editor
Section titled “Yoast SEO panel not appearing in product editor”1. Verify Products are enabled in Yoast:
- Go to SEO > Search Appearance
- Click Content Types tab
- Find Products in the list
- Ensure “Show Products in search results” is set to Yes
- Click Save Changes
2. Confirm products have synced from BigCommerce:
- Go to Commerce Connect > Products
- Verify at least one product appears in the list
- If no products show, check BigCommerce connection in Commerce Connect > Settings
3. Check user permissions:
- User must have
edit_postscapability for products - Yoast SEO meta box visibility is tied to post type edit permissions
- Admin users should see it automatically
4. Clear WordPress® cache:
- If using caching plugin (WP Rocket, W3 Total Cache), clear cache
- Try editing product in incognito/private browser window
Focus keyphrase score is red despite optimization
Section titled “Focus keyphrase score is red despite optimization”Critical understanding: Yoast analyzes BigCommerce content (product title/description), not just SEO metadata.
If you set focus keyphrase to “organic cotton blanket” but your BigCommerce product description doesn’t contain that phrase, Yoast will show a red score.
Solution workflow:
- Note the focus keyphrase you set in Yoast (e.g., “organic cotton blanket”)
- Click “Edit in BigCommerce” button at top of WordPress® editor
- Update product description in BigCommerce to include the focus keyphrase naturally
- Don’t keyword-stuff—write for humans first
- Include the phrase 1-2 times in a 300-word description
- Save in BigCommerce
- Wait for sync to WordPress® (usually instant via webhook, max 30 seconds)
- Refresh the product edit page in WordPress®
- Yoast re-analyzes the synced content and score should improve
Why this happens: Yoast can’t edit the product description (it’s managed in BigCommerce). It can only analyze what BigCommerce sends and recommend improvements.
Product description/title changed in BigCommerce but not updating in WordPress®
Section titled “Product description/title changed in BigCommerce but not updating in WordPress®”Check webhook delivery:
- In BigCommerce admin, go to Settings > API > Webhooks
- Find the Commerce Connect webhooks (usually prefixed with “WPE” or “WordPress®”)
- Check Recent Deliveries - should show successful 200 responses
- If seeing 4xx/5xx errors, webhook is failing
Force manual sync:
- In WordPress®, go to Commerce Connect > Settings
- Click “Sync Products Now” or “Force Full Sync”
- Wait for sync to complete (check Products list for updated data)
Clear WordPress® object cache:
- If using Redis/Memcached, flush cache
- Product data may be cached even after webhook delivers
Schema validation errors in Google Search Console
Section titled “Schema validation errors in Google Search Console”Common issues:
- Missing price
- Missing availability
- Invalid image URL
How to diagnose:
- Visit product page on live site
- Copy the URL
- Go to Google Rich Results Test
- Paste URL and test
- Review errors and warnings
Fix in BigCommerce:
- Ensure product has valid price set
- Ensure product is in stock or availability status is set
- Ensure product has at least one image
Meta description not updating in search results
Section titled “Meta description not updating in search results”Google doesn’t always use your meta description
Section titled “Google doesn’t always use your meta description”Even with a perfect meta description via Yoast, Google may choose to generate its own based on:
- Search query relevance
- Page content
- Algorithmic decision
What you can do:
- Ensure meta description is under 160 characters
- Include target keywords naturally
- Make it compelling and relevant
- Wait - Google can take weeks to update
Product pages showing “noindex” in Yoast
Section titled “Product pages showing “noindex” in Yoast”Check global settings:
- Go to SEO > Search Appearance
- Click Content Types tab
- Find Products
- Ensure “Show Products in search results” is set to Yes
Check individual product:
- Edit product in WordPress®
- Open Yoast SEO panel
- Click Advanced tab
- Ensure “Allow search engines to show this Product in search results” is set to Yes
Best Practices
Section titled “Best Practices”-
Optimize high-value products first
- Start with bestsellers and high-margin products
- Set focus keyphrases, custom meta descriptions
- Refine over time based on search performance
-
Use BigCommerce for content, Yoast for optimization
- Don’t duplicate work - write good descriptions in BigCommerce
- Use Yoast to refine how that content appears in search
-
Monitor search performance
- Use Google Search Console to track product page rankings
- Identify products with impressions but low clicks
- Improve meta descriptions to boost CTR
-
Leverage product categories
- Organize products into logical BigCommerce categories
- Categories sync to WordPress® taxonomies
- Use in breadcrumbs and internal linking
-
Keep meta descriptions unique
- Don’t use the same meta description across products
- Highlight what makes each product unique
- Include size, color, material variations if relevant
-
Test rich snippets
- Regularly validate schema markup
- Use Google Rich Results Test
- Fix errors to maintain rich snippet eligibility
-
Don’t over-optimize
- Focus keyphrase should appear naturally
- Don’t keyword-stuff product descriptions in BigCommerce
- Write for humans first, search engines second
SEO Workflow for New Products
Section titled “SEO Workflow for New Products”When adding a new product to BigCommerce:
-
In BigCommerce:
- Write clear, descriptive product title (include primary keyword)
- Write detailed product description (300+ words for high-value items)
- Add high-quality images with descriptive filenames
- Set price, inventory, availability correctly
- Assign to appropriate category
-
Wait for sync to WordPress®
- Product appears in Commerce Connect > Products
- Usually instant via webhook
-
In WordPress® (Edit in WordPress®):
- Scroll to Yoast SEO panel
- Set focus keyphrase (target search term)
- Review SEO analysis - check for green lights
- Customize meta description (if needed)
- Set social sharing image (if different from product image)
- Update product to save Yoast metadata
-
Validate:
- Visit product page on live site
- Test URL in Google Rich Results Test
- Check for schema validation errors
- Verify meta description displays correctly
-
Monitor:
- Add URL to Google Search Console
- Track impressions, clicks, position over time
- Refine based on performance
Why This Integration Matters: The Complete Value Proposition
Section titled “Why This Integration Matters: The Complete Value Proposition”For Merchants
Section titled “For Merchants”Problem: Traditional commerce platforms (Shopify, BigCommerce standalone) give you limited SEO control. Product pages are locked into platform templates with basic meta tag customization.
Solution: Commerce Connect + Yoast gives you enterprise-grade SEO tools on every product page:
- WordPress® is a native SEO platform (powers 43% of the web)
- Yoast is the industry-standard SEO plugin (14+ million active installs)
- Products rank as WordPress® content, not commerce platform iframes
Business impact:
- Higher organic traffic - Better SEO = more product page visibility in Google
- Lower customer acquisition cost - Organic search is free compared to paid ads
- Competitive advantage - Most commerce platforms can’t match WordPress® SEO depth
For Developers/Agencies
Section titled “For Developers/Agencies”Problem: Clients want BigCommerce catalog power (inventory sync, checkout, order management) but don’t want to sacrifice WordPress® SEO capabilities.
Solution: Commerce Connect gives you both—no compromise:
- Build on WordPress® (familiar CMS, ecosystem you know)
- Products sync from BigCommerce automatically
- Every WordPress® SEO plugin works out of the box (Yoast, Rank Math, All in One SEO)
Development benefits:
- No custom SEO implementation - Yoast handles structured data, sitemaps, meta tags automatically
- Client-friendly - Marketing team already knows Yoast from blog posts, can optimize products themselves
- Extensible - Add custom fields (ACF), custom schema, breadcrumbs via WordPress® plugins
For Marketing Teams
Section titled “For Marketing Teams”Problem: Managing product SEO across hundreds/thousands of SKUs is time-consuming. BigCommerce’s native SEO tools are basic.
Solution: Yoast gives you bulk optimization workflows and actionable SEO analysis per product:
- Focus keyphrase analysis - Yoast tells you exactly what to fix (keyphrase in title, description, density, etc.)
- Google preview - See how product appears in search before publishing
- Bulk editing - Use Yoast’s bulk editor to set meta descriptions across multiple products at once
- Performance tracking - Integrate with Google Search Console to see which products rank, which need work
Workflow efficiency:
- Catalog team manages products in BigCommerce (what you already do)
- Marketing team optimizes SEO in WordPress® (Yoast interface, no BigCommerce access needed)
- No conflicts - Both teams work in parallel, no stepping on each other’s toes
The “Edit in WordPress®” vs. “Edit in BigCommerce” Decision Tree
Section titled “The “Edit in WordPress®” vs. “Edit in BigCommerce” Decision Tree”Use “Edit in BigCommerce” when you need to:
- ✅ Change product price
- ✅ Update product description or title
- ✅ Manage inventory/stock levels
- ✅ Add/remove product images
- ✅ Change product categories
- ✅ Edit product variants (size, color, etc.)
Use “Edit in WordPress®” when you need to:
- ✅ Set focus keyphrase for search ranking
- ✅ Customize meta description (how product appears in Google)
- ✅ Preview search engine appearance
- ✅ Set social sharing image (different from product image)
- ✅ Add custom fields (via ACF or other plugins)
- ✅ Configure schema markup (product reviews, ratings, availability)
Rule of thumb: If it affects what you’re selling (product catalog), edit in BigCommerce. If it affects how you rank (SEO/marketing), edit in WordPress®.
Best Practices for Commerce Connect + Yoast
Section titled “Best Practices for Commerce Connect + Yoast”1. Optimize High-Value Products First
Section titled “1. Optimize High-Value Products First”Don’t try to SEO-optimize 1,000 products on day one. Start with:
- Bestsellers (highest revenue products)
- High-margin products (where organic traffic = highest profit)
- Products with search volume (use Google Keyword Planner to identify which products people search for)
Set focus keyphrases, custom meta descriptions, and validate schema markup for these first. Expand to long-tail products over time.
2. Write Product Descriptions in BigCommerce for Humans, Then Optimize in WordPress® for Search
Section titled “2. Write Product Descriptions in BigCommerce for Humans, Then Optimize in WordPress® for Search”BigCommerce description:
- Write naturally for customers (benefits, features, use cases)
- Include target keywords organically (don’t keyword-stuff)
- Aim for 300+ words for high-value products
Yoast meta description:
- Shorter (under 160 characters)
- Includes focus keyphrase + call to action
- Highlights unique selling points (free shipping, sizes available, etc.)
Example:
| BigCommerce Description (300 words) | Yoast Meta Description (156 chars) |
|---|---|
| “Crafted from 100% European flax linen, this duvet cover brings breathable luxury to your bedroom. Natural temperature regulation keeps you cool in summer, warm in winter. [continues for 200+ more words describing benefits, care instructions, etc.]" | "Luxury linen duvet cover - 100% European flax. Breathable, naturally temperature-regulating. King, Queen, Full sizes. Free shipping over $100.” |
3. Use BigCommerce Categories to Inform Focus Keyphrases
Section titled “3. Use BigCommerce Categories to Inform Focus Keyphrases”BigCommerce product categories sync to WordPress®. Use these to guide SEO strategy:
- Category: “Organic Bedding”
- Product: “Organic Cotton Throw Blanket”
- Focus keyphrase: “organic cotton throw blanket” or “sustainable throw blanket organic”
Match focus keyphrases to how customers search for products in that category.
4. Monitor Search Performance and Iterate
Section titled “4. Monitor Search Performance and Iterate”Week 1-2 after launch:
- Submit product URLs to Google Search Console
- Request indexing for high-priority products
- Verify rich snippets appear (use Google Rich Results Test)
Monthly:
- Review Google Search Console > Performance report
- Identify products with:
- High impressions, low clicks → Improve meta description to boost CTR
- Low impressions → Research better focus keyphrase or update product description in BigCommerce
- Declining position → Check for new competitors, refresh content
Quarterly:
- Update meta descriptions based on seasonal search trends
- Refresh product descriptions in BigCommerce (Google rewards fresh content)
- Add schema markup for new features (product reviews, ratings, Q&A)
5. Leverage Schema Markup for Rich Snippets
Section titled “5. Leverage Schema Markup for Rich Snippets”Yoast automatically adds basic Product schema. For maximum search visibility:
Enable product reviews (if using reviews):
- BigCommerce product reviews sync to WordPress®
- Yoast adds
aggregateRatingto schema automatically - Google may show star ratings in search results
Add availability status:
- Ensure products have correct stock status in BigCommerce
- Yoast reads
in_stock/out_of_stockand adds to schema - Google shows “In stock” / “Out of stock” in results
Validate regularly:
- Use Google Rich Results Test monthly
- Fix any schema errors immediately (missing price, invalid image URL, etc.)
- Rich snippets = higher click-through rate = more organic traffic
6. Don’t Over-Optimize
Section titled “6. Don’t Over-Optimize”Avoid keyword stuffing:
- Don’t repeat focus keyphrase 20 times in product description
- Yoast will flag “keyphrase density too high”
- Google penalizes unnatural keyword use
Write for humans first:
- Customers buy from good product descriptions, not keyword-stuffed nonsense
- Use focus keyphrase naturally 2-3 times in a 300-word description
- Include synonyms and related terms (Google understands semantic search)
Meta description best practices:
- Don’t just repeat product title
- Include unique selling point or call to action
- Mention what differentiates this product from competitors
Common Questions
Section titled “Common Questions”Q: Do I need to re-enter product data in WordPress®? A: No. Products sync automatically from BigCommerce to WordPress® via API/webhook. You only manage SEO metadata in WordPress® (focus keyphrase, meta description).
Q: If I update a product in BigCommerce, do I lose my Yoast SEO settings in WordPress®? A: No. Product data (title, description, price) syncs from BigCommerce. SEO metadata (focus keyphrase, meta description) is stored separately in WordPress® and is NOT overwritten during sync.
Q: Can I bulk-edit Yoast SEO metadata across multiple products? A: Yes. Yoast SEO Premium includes a bulk editor. Go to SEO > Tools > Bulk Editor, filter by post type “Products”, and edit meta descriptions/titles in bulk.
Q: What happens if I accidentally edit product title/description in WordPress®? A: Those fields are read-only (grayed out) in the WordPress® product editor to prevent this. If you need to edit product catalog data, you must use “Edit in BigCommerce” button.
Q: Do product categories from BigCommerce work with Yoast breadcrumbs? A: Yes. BigCommerce categories sync to WordPress® taxonomies. Yoast breadcrumbs automatically use these for product navigation (Home > Bedding > Organic Cotton Throw Blanket).
Q: Can I use Rank Math or All in One SEO instead of Yoast?
A: Yes. Commerce Connect products are standard WordPress® product post type. Any WordPress® SEO plugin that supports custom post types will work (Yoast, Rank Math, All in One SEO, SEOPress, etc.).
Q: How do I know if Google is indexing my products correctly? A: Use Google Search Console:
- Go to Coverage report
- Filter by URL prefix (e.g.,
yoursite.com/products/) - Check for indexing errors
- Use URL Inspection Tool to test specific product URLs
Related Documentation
Section titled “Related Documentation”- Custom Fields - Add custom fields to products beyond SEO metadata
- Product Templates - Customize how products display on the frontend
- Product Sync - How BigCommerce products sync to WordPress® (webhook architecture)