Added color and image swatches to the Woo Attribute Selector. Swatches support automatic variation images, custom CSS mappings, optional visible labels, selected and unavailable states, and the same keyboard and screen-reader behavior as the existing radio modes.

Added a Woo Cart Amount component for shopper-facing subtotals, discounts, fees, shipping, tax, and final totals. It can follow the store’s tax display setting or explicitly show amounts including or excluding tax, and it distinguishes free shipping from shipping that has not been calculated yet.

Added a Woo Product Provider for sharing product and selected-variation state across a custom product layout. New Product Price, SKU, Availability, Description, Product Image, and Product Media components can now react together when a shopper changes a variation, while still rendering useful server-side and no-JavaScript output.

Added three purpose-specific Woo quantity controls: an optional purchase-draft stepper for Add to Cart, a button-based Cart Item Quantity stepper, and a Product Cart Quantity control for changing the confirmed cart quantity of the product or variation in the nearest Product Provider. Each control respects WooCommerce quantity, stock, decimal-step, and sold-individually rules.

Added a public Facet Events API for observing Select, Search Select, Checkbox List, Radio List, Map, Map Address, and Map Radius interactions; customizing newly inserted Facet Target content; and reacting to completed target updates and response metadata.

Cart actions now share a confirmed-state mutation coordinator. Rapid quantity changes collapse safely to the latest valid target, different cart actions run in a deterministic order, failed requests no longer block later actions, and cart rows, totals, notices, and counts stay aligned with WooCommerce’s confirmed response.

Expanded the live documentation with Product Purchase, Cart Items, Cart Totals, and a complete Facet Events API reference covering lifecycle diagrams, payload contracts, and integration examples.

Fixed Accordion pages jumping to the bottom of a long panel when another item is opened. The newly opened item’s header now stays at the start of the visible page, making long accordion content easier to follow.

Fixed nested Navigation Menu Mobile transitions on iOS, kept the Close button stationary when the Back button appears, removed an invisible drawer-title layout item, and moved focus into an active child panel without triggering blocked aria-hidden warnings or unwanted scrolling.

Preserved the released visibility behavior of existing Woo Attribute Selector modes while ensuring unavailable or hidden swatches stay out of the layout and expose clear selected, unavailable, and fallback states.

polished keyboard navigation for navigation components.

polished new map addresses and radius facets

Added Serialized Multi-Value Meta mode for Search, Select, SearchSelect, Radio List, and Checkbox List facets. Sites can now filter fields that store multiple selected values inside a serialized string-array meta field, such as Meta Box, ACF, or custom multi-select and checkbox fields. Multiple selected values for the same serialized meta key match any selected value, combine with other active facets normally, restore from URLs, and keep option availability in sync.

Added map proximity filtering with Map Address Facet, Map Radius Facet, and Map Radius Facet Option. Visitors can search an address or ZIP code through the LocationIQ integration, choose a radius in miles or kilometers, and filter results by stored latitude and longitude meta. A paired Map Facet recenters, fits the selected radius, and draws the radius circle as the selection changes.

Added a complete Oh My IDEtch LocalWP Devkit documentation section, covering install and preparation, first-project setup, the daily check/sync workflow, command reference, troubleshooting, and shipping a production plugin ZIP.

Improved keyboard and screen-reader accessibility across facet controls. Search, Select, SearchSelect, Radio List, Checkbox List, Reset, Pagination, and Load More facets now expose clearer control semantics, disabled states, keyboard behavior, and result announcements. Facet targets announce loading and result-count changes politely after updates.

Improved keyboard and screen-reader accessibility of the Navigation Menu (desktop and mobile). Keyboard users now Tab into the menu once and move between dropdown triggers with the arrow keys, focus jumps to the first link when a dropdown opens, pressing Escape or clicking outside returns focus to the trigger, and open/close state is announced to screen readers. The mobile drawer now locks the background while open.

Fixed ARIA semantics defects in the Navigation Menu and Drawer. The desktop menu trigger no longer falsely announces itself as a menu opener because the disclosure panel it controls is not a role=”menu”. The mobile menu’s submenu triggers now correctly reference the panels they open via aria-controls, mixed link/arrow rows now use a valid menu-item role, and standalone Drawers authored without a title now receive a generic accessible name instead of rendering as unnamed modal dialogs.

Added support for the main-query loop type in faceted filtering. A Facet Target can now filter the main query loop types in archive templates etc.

Added an optional caption slot to the Lightbox Item. Authored caption markup is shown inside the opened lightbox overlay, and the caption wrapper’s classes are copied onto the visible caption so each item can control its caption styling. Empty caption slots keep the existing no-caption behavior.

Rewrote the entire WooCommerce documentation set for end users, with clearer explanations of cart, checkout, product, and selector component families and how they fit into real storefront flows.

removed some duplicated props in some of the components

Fixed the Stripe payment field failing to mount at checkout in the optimized checkout build, where the payment iframe never appeared and the field reported the provider as unavailable.

Fixed a regression introduced in 1.5.3 where several facet controls showed duplicate fields in the Etch editor — most noticeably two “Value” fields , and a duplicated “Argument Mode” setting across Select, Radio List, Checkbox List, and Search Select facets (including Search Facet). Option values, query mappings, and all single- and multi-argument filtering behavior continue to work as before; only the extra editor fields are removed.

Added 18 component starter patterns for Accordion, Breadcrumbs, Carousel, Dialog, Drawer, Lightbox, Navigation Menu, Table of Contents, and Tabs, giving authors ready-made examples for common component setups.

Added 9 Woo starter patterns for product cards, product lists, carts, checkout layouts, and mini-cart drawers, making it faster to assemble Woo storefront flows from reusable starting points.

Added Lightbox group support so separate lightbox areas can intentionally open as one shared gallery while existing isolated lightbox behavior remains unchanged by default.

Improved the Patterns panel so component starter patterns can be organized, typed, and displayed more consistently alongside the rest of the pattern library.

Improved pattern synchronization reliability and moved remote pattern sync workflows to the dedicated patterns site.

Fixed Facet Pagination and Load More behavior when a Facet Target starts from a base offset, preventing repeated or skipped results across paginated batches.

Fixed Woo Stripe payment field mounting so Stripe UPE fields initialize more reliably in Woo checkout flows.

Added a Woo Variation Reset Button so product forms can clear selected variation attributes and return to an unselected state.

Added Woo variation gallery, and product gallery dynamic data so variable products can expose selector-aware image and gallery payloads for custom product media layouts.

Improved Woo checkout address field styling with exposed UIChoice style controls for country and state selectors.

Improved shared UIChoice mode styles with lower-specificity selectors, making authored select, radio, button-radio, chip, and swatch styles easier to override.

Improved Woo documentation with custom browser event contracts, class-prop style ID references, checkout route-entry guidance, and updated dynamic data references.

Fixed Woo checkout entry handling so Etch-authored checkout pages can restore Store API token carts after hard navigation, including checkout shells authored in block templates and template parts.

Fixed Woo AttributeSelector controls inside Facet Target product loops so variation selectors hydrate again after filtered results are replaced.

Fixed Woo AttributeSelector first-option behavior so automatic selections no longer steal focus or scroll the page.

Added official Woo Stripe gateway support for Woo checkout flows, including card, BLIK, Przelewy24, iDEAL/Wero, Bancontact, EPS, Alipay, SEPA, voucher, and buy-now-pay-later payment methods.

Improved Woo checkout payment handling with gateway field slots, clearer payment method readiness states, safer payment payload preparation, and better checkout result handling.

Improved Woo payment and checkout documentation, including the template integration contract and checkout gateway fields slot.

Improved component organization by grouping components with native pattern categories, making related components easier to find.

Improved documentation search setup and crawler configuration for the docs site.

Fixed the Load More Facet so clicking the button can load the next batch reliably after the 1.5.0 release.

Fixed duplicate Pagination Facet roots so multiple pagination controls for the same target stay in sync.

Fixed Accordion open animation sequencing for smoother and more reliable open states.

Fixed component default styles so fixed styles are registered automatically and consistently.

Fixed Woo product dynamic data so product context is available in production.

Fixed Woo Store API cart sessions so carts persist across hard navigation after adding a product.

Fixed Woo cart item images so responsive srcset data is preserved.

Fixed Woo coupon empty states so server-rendered coupon areas only show when coupon summary data exists.

Fixed Woo checkout notices so payment adapter errors are surfaced to the customer instead of failing silently.

Fixed Woo variation selection so multi-attribute products resolve complete purchasable combinations correctly.

Added Woo v1 — a complete WooCommerce component pack for building product, cart, and checkout experiences directly in Etch.

• Product purchase components: Add To Cart Button, Add To Cart Form, Buy Now Button, and Attribute Selector.
• Cart state components: Cart Count, Cart Items, Cart Item Title, Cart Item Image, Cart Item Price, Cart Item Subtotal, Cart Item Quantity, Cart Item Remove, Cart Attribute List, Cart Attribute Name, and Cart Attribute Value.
• Totals and coupon components: Cart Totals, Totals Subtotal, Totals Discount, Totals Shipping, Totals Tax, Totals Total, Coupon Form, Coupon Applied List, and Coupon Remove Button.
• Checkout components: Checkout Provider, Checkout Form, Billing Address Form, Shipping Address Form, Shipping Method Selector, Payment Method Selector, Terms Checkbox, Order Summary, Place Order Button, Checkout Notices, and Cart Notices.

Added a Woo runtime powered by the WooCommerce Store API, with live cart updates, add-to-cart actions, coupon actions, quantity changes, item removal, checkout field sync, shipping/payment selection, and checkout submission.

Added Woo dynamic data for products, variations, cart items, cart totals, coupons, shipping rates, payment methods, prices, media, purchase state, attributes, and selected variation context.

Added the new Load More Facet component so visitors can load the next batch of Facet Target results without switching pages.

Added separate span count display for facet option counts, giving Checkbox List, Radio List, Select, and Search Select facets more flexible styling for availability counters.

Added manual links and taxonomy controls to Breadcrumbs, so authors can insert custom crumbs and exclude automatic taxonomy crumbs from singular trails.

Added an icon-only trigger option to Navigation Menu Mobile, with a separate accessible label when visible trigger text is hidden.

New documentation site with dedicated docs for Woo components, facets, UI components, recipes, dynamic data, and an LLM-friendly hub page.

Improved facet pagination and load-more behavior so rendered loop sizes can be inferred more reliably from the current target markup.

Improved facet target behavior inside nested Etch loops so filtering preserves the correct loop context.

Changed the component settings dashboard with a simpler component-management view and external documentation links.

Fixed Pagination Facet initialization when range output is disabled.

Fixed deep archive facet requests by raising the maximum supported offset for large result sets.

Fixed mapped-bundle facet hydration when a filtered result set has zero items.

Fixed facet option availability counts so separate counter spans update and reset correctly across checkbox, radio, select, and search-select options.

Added responsive accordion mode to Tabs — tabs can now switch into a true accordion at a configured mobile breakpoint, with Etch preview controls, optional chevrons, styling hooks, and accordion-specific keyboard behavior.

Added Carousel transition effects — choose fade, coverflow, flip, cube, cards, or creative effects from structured controls while keeping the original slide effect as the lightweight default.

Added 15 new patterns to the Pattern Library:

• 1 About pattern.
• 1 Bento Grid pattern.
• 3 Blog Post patterns.
• 1 Blog Section pattern.
• 1 CTA pattern.
• 1 Feature Section pattern.
• 1 Gallery pattern.
• 2 Hero patterns.
• 1 Pricing pattern.
• 1 Team pattern.
• 2 Testimonial patterns.

Improved responsive Tabs behavior so authored trigger and panel content is preserved when moving between desktop tabs and mobile accordion layouts.

Improved Carousel effect handling so custom JSON can refine the selected effect, but cannot accidentally switch the carousel into a different effect mode.

Improved facet request validation and response caching for complex filter setups, making availability data, mapped bundle filtering, and cached responses more reliable.

Improved license management requests in the admin app so status checks, activation, deactivation, and refresh actions use consistent authenticated request handling.

Fixed Carousel state preservation after browser visibility changes, keeping the active slide and navigation state stable when a tab is hidden and shown again.

Fixed facet availability caching edge cases, including corrupted cache payloads and empty availability results.

Tightened facet request handling for invalid offsets, unsupported availability descriptors, query budget limits, and untrusted forwarded headers.

Added a new Breadcrumbs component — automatically render WordPress-aware breadcrumb trails for pages, posts, custom post types, archives, taxonomy pages, search results, and 404 pages, with optional schema output and styling controls.

Added a new Table of Contents component — generate navigable heading links from page or post content, with nested lists, smooth scrolling, active-section highlighting, hash syncing, and dynamic content support.

Readable facet URLs — facet links now use clear query params like ?search=chairs&price=21, while pages with multiple targets use clear prefixes like ?products.search=chairs. Existing ome[target][key] links continue to hydrate for this release, but new interactions write the readable format.

Expanded the Search Facet with configurable query argument modes — search inputs can now target standard WordPress query args, meta fields, taxonomy terms, dates, ACF relationship fields, or multiple query arguments with AND/OR behavior.

Added facet cache diagnostics in the admin app — site admins can view local cache-tier counters and turn collection on or off, helping confirm how facet caching behaves in production without exposing visitor data.

Added 2 Blog Post patterns to the Pattern Library, including layouts with breadcrumbs, sticky sidebars, article content structure, and responsive mobile ordering.

Fixed Lightbox images on sites using lazy-loading plugins — full-size images now resolve from data-src, data-lazy-src, srcset, lazy srcset, and <picture> sources instead of opening placeholder images.

Fixed public facet requests so visitor-facing filters no longer send a REST nonce by default, while authenticated nonce behavior remains available through a compatibility filter.

Fixed Search Facet URL hydration so query argument values restored from the address bar are applied correctly

Fixed readable facet URL edge cases, including repeated range values and reset behavior across single-target and multi-target pages

Added shareable filter URLs for facets — filter states (search, checkbox, radio, select, tags, pagination, and map viewport) are now written to the browser address bar, so you can copy, bookmark, and share the exact filtered view with

Added mapped bundle query flows for facets — map a single facet value to multiple query targets at once, so selecting one option can filter several result sets simultaneously without extra setup.

Added 15 new patterns to the Pattern Library:

• 5 About section patterns (1–5) with editorial layouts, team rails, sticky badge rails, and stats bands.
• 5 Hero section patterns (25–29), including full-viewport carousels, orbital icon visuals, and overlapping content-card layouts.
• 3 Gallery patterns (1–3) with grid layouts and lightbox support.
• 1 Testimonial section pattern (#11) with a centered carousel and header navigation rail.

Debug log output is now guarded behind the dev mode flag, keeping production logs clean and quiet.

Fixed the map facet so the loading spinner no longer gets stuck when a fetch request fails — the map now recovers gracefully and shows an empty state instead.

Fixed map facet programmatic bounding-box updates that could unexpectedly shift the map viewport during filtering.

Fixed a facet scope snapshot issue where map and pagination clauses were not always captured correctly, which could cause filters to lose context.

Added 31 new patterns to the Pattern Library:

• 8 Header patterns with navigation menus, mobile drawers, dropdowns, and action buttons.
• 8 FAQ section patterns with accordion and expandable layouts.
• 4 Hero section patterns (21–24)
• Testimonials section patterns in a variety of grid and carousel layouts.
• Feature Section pattern (#20).

Added responsive breakpoint controls to the Carousel — configure how many slides are visible and the spacing between them at different screen widths, so carousels look great on every device.

Added external pagination dots for the Carousel — place dot navigation anywhere on the page and link it to a carousel for flexible layout control.

Added a centered slides mode for the Carousel — the active slide is centered with adjacent slides peeking in from the sides, perfect for hero sections and featured content.

Added infinite scroll loading for facet targets — results load automatically as users scroll down, eliminating the need for manual pagination in long result lists.

Added custom json mode for carousel – you can just paste JSON config for swiper carousel setting instead of using props settings for it

Added a scroll-to-top option for pagination facets and facet targets — after filtering or paginating, the page smoothly scrolls back to the results area so users never lose context.

Added listed and selected marker states for map facets — markers now show distinct icons for items appearing in the current result set versus the one currently selected with an open popup.

Added a fallback tag option for facet targets — choose the wrapper element type so facets integrate properly inside table rows and other semantic containers instead of defaulting to a generic wrapper.

Improved the reliability of the pattern library sidebar on slower servers — the app now waits patiently (up to 2.5 minutes) for the editor to finish loading before mounting, instead of giving up after just a few seconds.

Fixed the navigation menu so the dropdown width no longer snaps abruptly during the close animation — it now holds the correct width until the transition finishes.

Fixed facet option labels containing special characters (like `&`) so they display correctly instead of showing escaped text.

Fixed carousel slides per view to support the `auto` option and fractional values — slides are no longer forced to fill the entire carousel width when using content-driven or partial-visibility layouts.

Fixed a visual flash on facet targets during the initial page load — content that is already visible from the server no longer briefly fades out while filters initialize.

Fixed map facet clustering so markers outside the current result set stay properly grouped, reducing stray single-bubble clusters.

Fixed map facet marker popups so slot content loads reliably for all markers in scope, not just the visible ones.

Fixed map-paired targets so they remain hidden until the map has finished its first hydration, preventing a flash of unfiltered content.

Improved the reliability of the pattern library sidebar on slower servers — the app now waits patiently for the editor to finish loading before mounting, instead of giving up after just a few seconds.

Patterns Library v1

EXPERIMENTAL: Map Facet component family. This component is not finished yet and might (probablay will) have some breaking changes in the future. But you can have some fun with it on staging/local instance. Just don’t use it in prod yet.

Implementation of etch conditional prop for all Oh My Etch components for better user experience when using Oh My Etch Component.

Fixed several edge cases when multiple facet types are used together, improving consistency across search, checkbox, radio, pagination, and reset filters.

Added a new “Reset” button component that clears all facet filters at once, making it easy for users to start a fresh search without manually unchecking each option.

Added keyboard navigation support to radio button facets, so users can move through options using arrow keys for a more accessible experience.

Fixed reliability issues with facet filters on cached pages, ensuring filters work correctly even when pages are served from cache.

Improved facet template storage to be more resilient and self-healing when edge cases occur.

Improved facet system architecture for better maintainability and reliability, resulting in more consistent filter behavior across all facet types.

Updated internal code quality tooling to ensure continued stability and code consistency.

Added support for default selected values in Select and Checkbox facets, so filters can start with pre-defined choices already applied.

Improved overall facet reliability, especially when filters load quickly or multiple requests happen close together.

Fixed cases where facets could appear ready before all filter data was fully available.

Fixed an issue where Checkbox facets using the IN meta key operator could fail when only a single value was selected.

Fixed facet targets so they correctly pick up and use the initial filter conditions defined by the author.

Improved internal validation so facet behavior is more consistent across different configurations.

Improved block and pattern loading reliability in some environments.

Added extra safeguards for startup loading and frontend asset paths.