Note:
WooCommerce blocks are the simplest, most flexible way to display products on posts and pages. Learn more about WooCommerce blocks.
WooCommerce has traditionally utilized shortcodes to add dynamic content and features to WordPress pages. With WordPress’s evolution toward the Gutenberg block-based editor, the focus has shifted from shortcodes to more interactive and visually integrated blocks.
While the block editor offers interactively customizable blocks and enhanced editing capabilities, we recognize many stores still lean heavily on shortcodes. You can use legacy shortcodes inside a shortcode block.
How to use shortcodes #
Where to use shortcodes #
Shortcodes can be used on WordPress posts and pages. If you are using the block editor, you can paste the shortcode into a shortcode block.
If you are using the Classic Editor, you can paste the shortcode directly into the page or post content.
Shortcode attributes #
Some shortcodes allow you to modify them to make them more specific or display content in a certain way. You can modify shortcodes by adding attributes (AKA arguments or args) to them.
For example, adding the attribute id to the [add_to_cart] shortcode will create an add-to-cart button for a specific product. [add_to_cart id=”99”] displays an add-to-cart button for the product with an ID of 99 in your shop.
WooCommerce shortcodes #
The table below provides an overview of the shortcodes available in WooCommerce. Each item includes a brief description and a link to shortcode-specific documentation.
As WooCommerce has moved to block-based store editing, we’ve also included links to block alternatives for each shortcode (where applicable).
| Shortcode | Description | Learn more | Block alternative |
[woocommerce_cart] | Displays the cart page. | Cart shortcode | Cart block |
[woocommerce_checkout] | Displays the checkout page. | Checkout shortcode | Checkout block |
[woocommerce_my_account] | Displays the user account page. | My account shortcode | None yet |
[woocommerce_order_tracking] | Displays the order tracking form; has attributes. | Order tracking shortcode | None |
[product_page] | Displays a full single product page by ID or SKU. | Product page shortcode | Custom product page templates can be made using the store editor |
[products] | Displays products by specific parameters; has attributes. | Product collection block (and others*) | Product collection block (and others*) |
[product_category] | Displays products in a specified category; has attributes. | Product category shortcodes | Product collection block |
[product_categories] | Displays product categories; has attributes. | Product category shortcodes | None yet |
[add_to_cart] | Displays an add-to-cart button for a product; has attributes. | Add-to-cart shortcode | Available on single product page templates |
[add_to_cart_url] | Gets the URL of an add-to-cart button for a product; has attributes. | Add-to-cart URL shortcode | None |
[shop_messages] | Displays shop messages on non-WooCommerce posts or pages. | Shop message shortcode | Store notices block |
Note;
A variety of blocks display products with different options, including the all products block, hand-picked products block, products by category block, products by tag block, and more.
These are being deprecated in favor of the more robust and versatile product collection block.
If you need help, please review troubleshooting shortcodes and code snippets for assistance with common shortcode-related problems.
Questions and support #
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. By searching this forum, 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 WooCommerce Marketplace.
- Need ongoing advanced support or a customization built for WooCommerce? Hire a Woo Agency Partner.
- Are you a developer building your own WooCommerce integration or extension? Check our Developer Resources.
