1. Documentation /
  2. Widgets included with WooCommerce

Widgets included with WooCommerce

Several widgets come with WooCommerce that help you display products in a multitude of ways in your themes widgetized areas. Although, in modern themes, adding WooCommerce Blocks to widget areas is a more versitile and flexible approach.

Included Widgets

↑ Back to top

The default included wigets below, now referred to as Legacy Widgets, are still available to add to your theme’s widget areas. The widget icon is a quick way to differentiates widgets from similarly-named blocks.

The four default widgets are:

  • Cart – a summary showing what’s in the cart.
  • Products list – a limited list of all, featured, or on-sale products.
  • Products by Rating list – a list of your store’s top-rated products.
  • Recently Viewed Products list – a list of a customer’s recently viewed products.

Adding WooCommerce Blocks to Widget Areas

↑ Back to top

There’s also a growing list of more flexible and powerful WooCommerce Blocks that can be added in addition to or instead of the widgets above. Check out WooCommerce Blocks for more details about what’s available and what they can do.

Location

↑ Back to top

Options for where to play your widgets can be found under Appearance > Widgets, but what’s available to you depends on the active theme on your site. As an exeamle, the areas below are available with Storefront Theme. Select a location, and then click the plus sign to find and add a widget or block.

Widget areas as seen in Storefront theme.

Highlighted Widgets

↑ Back to top

Products list

↑ Back to top

With the Products list widget, you can display your products ordered by date, price, sales or randomly. Additionally, you can display products from all of your products, only featured products, or only products on sale.

You can set a title for the widget, number of products to show, and reorder them.

Examples:

  • To show most recent products, use All Products, Order by Date, and Order DESC.
  • To show 10 random featured products, set Number of products to show for 10, then use Featured Products, and then order by Random. 

Transforming legacy widgets into blocks

↑ Back to top

Several widgets have been converted into blocks. Blocks provide more customization options for merchants and offer a better user experience to shoppers.

In order to transform existing widgets into blocks, click on the block icon to open the Transform to menu. From the available options, select the equivalent block:

Questions and Support

↑ Back to top

Do you still have questions and need assistance? 

This documentation is about the free, core WooCommerce plugin for which support is provided in our community forums on WordPress.org. Searching there you’ll often find that your question has been asked and answered before.

If you haven’t created a WordPress.org account to use the forums, here’s how.

  • If you’re looking to extend the core functionality shown here, we recommend reviewing available extensions in the Woo Marketplace.
  • Need ongoing advanced support, or a customization built for WooCommerce? Hire a WooExpert agency.
  • Are you a developer building your own WooCommerce integration or extension? Check our Developer Resources.

If you weren’t able to find the information you need, please use the feedback thumbs below to let us know! 🙏