BigCommerce Product Update Headaches: Caching, Themes, and JSON-LD Explained

Navigating BigCommerce Product Update Frustrations: Caching, Theme Logic, and Schema Editing

BigCommerce merchants often face perplexing issues when product updates don't behave as expected. A recent forum thread highlights common frustrations: product description edits failing to stick, variant images not swapping dynamically, and structured data (JSON-LD) proving difficult to modify. This community insight from Big Migration dives into these challenges, offering clarity on underlying causes and potential solutions.

The Case of the Elusive Product Description Updates

The original poster, Jeannie Hill, described new product descriptions failing to update on the storefront, even after significant wait times. This is a common pain point for many BigCommerce users.

Daniel Olvera from Trepoly.com initially suggested CDN caching, advising to contact BigCommerce support to clear the store's cache. However, Jeannie reported this wasn't a universal fix, indicating a deeper problem.

Solomon Lite provided a more comprehensive diagnosis, explaining such delays are typically a combination of factors:

• Theme or CDN Caching: Delays due to various caching layers.
• Page Builder Limitations: Content blocks might not re-render immediately.
• Browser or Server-Side Cache: Holding onto older content.

This multi-layered caching environment explains why changes might only appear after a significant wait or forced refresh.

The Mystery of Non-Swapping Variant Images

Jeannie also faced new variant images failing to display, suspecting her theme (Chiara Furniture) lacked support for dynamic image swapping. Solomon Lite confirmed this, stating that variant image swapping is theme-dependent. If a theme doesn't fully implement BigCommerce’s variant image logic, images may fail to display consistently or require a full page reload. This highlights the critical role of theme development and its adherence to BigCommerce's evolving capabilities.

Navigating JSON-LD Editing on BigCommerce

Jeannie sought to edit JSON-LD to change specific placeholder text. Daniel clarified that the text ("Please enter the text as you would like it to appear in 'your text here'.") is typically a Product Option name, editable within product options, not JSON-LD itself.

Solomon further explained that BigCommerce does not provide a native UI for JSON-LD editing. Structured data is usually auto-generated by the theme or rendered via template files (e.g., product schema partials). Therefore, editing values within the JSON-LD schema requires theme-level template changes, rather than adjustments through Page Builder or standard product fields, necessitating a deeper technical understanding and direct access to theme files.

Key Takeaways for BigCommerce Merchants and Developers

This thread underscores several crucial points for managing a BigCommerce store:

• Caching is Ubiquitous: Always consider CDN, theme, browser, and server-side caching. Contacting BigCommerce support for cache clearance is a viable first step.
• Theme is Critical: Advanced visual features like dynamic variant image swapping are theme-dependent. Older or less robust themes may require customization or updates.
• JSON-LD Requires Technical Acumen: Direct manipulation of structured data often necessitates diving into theme files and understanding Stencil template logic.
• Page Builder Nuances: Content blocks might not always re-render instantly, contributing to perceived update delays.

Ultimately, resolving these intertwined issues often requires a targeted review of how your specific theme handles caching, variant logic, and schema output. Understanding these layers is key to effectively managing content and functionality on your BigCommerce store.