Shop owner reviews product cards and sale badges while planning a WooCommerce 11.3.0 update. Shop owner reviews product cards and sale badges while planning a WooCommerce 11.3.0 update.

WooCommerce 11.3.0 Adds Sale Badge and Block Controls

WooCommerce 11.3.0, released November 11, adds new sale-badge options, styling controls for product blocks, mobile gallery changes and a refund policy page setting. The release also includes developer-facing API and reporting updates.
Some links in this article are affiliate links. If you buy through them we may earn a commission, at no extra cost to you. Our conclusions are never for sale. How we make money

WooCommerce 11.3.0 became available on November 11, 2026, with changes to product presentation, store settings and developer integrations. For store owners and developers deciding what to check before updating, the main changes are flexible sale badges, additional block styling, a refund and returns policy setting, and updates to APIs and Analytics.

In brief: WooCommerce 11.3.0 is marked as backwards compatible, but it includes a database update. The release adds controls for sale badges and product blocks, native scrolling for the Product Gallery block on mobile, and a setting for the refund and returns policy page. Developers should review the release notes for the changes to REST API refunds, product filtering, the Shop page template and Analytics data before updating.

WooCommerce 11.3.0 changes how product promotions appear

The release’s most visible change is to the On-Sale Badge block. Store owners can set it to show a discount amount, a percentage or custom text, rather than relying only on a standard sale label. The block appears in product collections and galleries, and the release says its appearance can be configured alongside the new styling controls.

WooCommerce also adds color, spacing and border controls to Product, Featured Product, Featured Category, Product Categories List and other catalog blocks. The release describes these as curated controls for each block, aimed at making more designs possible without custom code. Featured Category can also be placed inside Terms Query to create a collection of product categories with a unified design.

For shops that use the Product Gallery block, the update switches mobile image movement to native scrolling and scroll snap. The WooCommerce release notes say images follow the shopper’s finger and respond to quick flicks with natural momentum. The update also works alongside product variation image galleries, which the release describes as a recent addition.

Refund policy settings and Analytics updates

Merchants can now select a refund and returns policy page in WooCommerce. The release says WooCommerce labels the selected page in the Pages list and adds structured data linking to it, so search engines and agents can find the policy without custom markup.

The Analytics Orders report gains a payment-method column, a CSV export column and an advanced filter. The release notes say the database update adds a nullable payment_method column to wc_order_stats and fills it for existing orders through a background update. For large stores, the notes flag that building the new index reads the table and takes time and disk I/O; they recommend planning the update for a quiet period.

That database work makes the release’s “database update: yes” status especially relevant to store operators. Check the release notes and the update guidance before scheduling an update, particularly if the store has a large order table or custom reporting code.

Developer changes to check before updating

WooCommerce 11.3 changes how the Products REST API and Store API combine on_sale with include or exclude. The release says using each parameter alone is unchanged, but combinations now return results that reflect both filters. Extensions that make these combined requests should be retested against the new behavior.

The release also adds explicit validation for line-item refund amounts supplied to the REST API refund endpoint. It changes the effective template reported for the Shop page when a block theme is active, and updates the WooCommerce MCP connection. These details matter most to developers maintaining integrations, themes or extensions that depend on those behaviors.

One release detail is worth checking carefully: the page’s release summary lists 1,343 PRs and 111 contributors, while its description refers to more than 1,300 commits and 117 contributors. The notes do not reconcile those different contributor totals, so this article does not treat them as one confirmed figure.

What store owners should do next

Review the WooCommerce 11.3.0 release notes and update guidance before applying the release. Confirm the database update is planned for an appropriate maintenance window, then check any extensions or custom code that uses the affected product filters, Shop page template metadata, REST API refunds or Analytics queries.

For stores that use catalog blocks, test the sale badge, styling controls and mobile gallery on a staging site before changing the live storefront. Those are the clearest customer-facing changes in this release, and a quick review will show whether the new options fit the store’s existing design.

Looking for extensions? The WooCommerce Marketplace is one place to review options for a store. Check compatibility with your WooCommerce version and test changes on staging before installing them. This is an affiliate link: WP Gazette may earn a commission from qualifying purchases at no extra cost to you.

FAQ

When did WooCommerce 11.3.0 come out?

WooCommerce published the 11.3.0 release notes on November 11, 2026. The post says the release is available to download.

Does WooCommerce 11.3.0 include a database update?

Yes. The release marks “Database update: yes.” It also describes a background update that fills the new payment-method field in the Analytics order statistics table.

What should developers test in WooCommerce 11.3?

Check integrations that combine product filters such as on_sale with include or exclude. Also review code that reads Shop page template metadata, creates REST API refunds or joins order data into Analytics queries.

Leave a Reply

Your email address will not be published. Required fields are marked *