WooCommerce: Move & Customize Upsells @ Single Product

Keeping WooCommerce upsells at the very bottom of the single product page it’s kinda boring. In my view, WooCommerce users want to know there are upsells even before they scroll down (you also might want that: upsell means more profit). Amazon does that too.

In this tutorial, we will see not only how to move them to the top, right below the Add to Cart, but also how to customize the upsells output to show just 2 columns and remove default WooCommerce “loop” elements such as the Add to Cart. Enjoy!

Move WooCommerce product upsells under the “Add to Cart” button and customize them

PHP Snippet 1: Move (a.k.a. remove, then re-add) Product Upsells Under Add to Cart @ Single Product Page

 * @snippet       Move upsells - WooCommerce Single Product
 * @how-to        Get CustomizeWoo.com FREE
 * @author        Rodolfo Melogli
 * @compatible    WooCommerce 3.5.7
 * @community     https://businessbloomer.com/club/

remove_action( 'woocommerce_after_single_product_summary', 'woocommerce_upsell_display', 15 );

add_action( 'woocommerce_single_product_summary', 'woocommerce_upsell_display', 39 );

PHP Snippet 2: Change Product Upsells Output to 2 Columns @ Single Product Page

 * @snippet       Edit upsells columns - WooCommerce Single Product
 * @how-to        Get CustomizeWoo.com FREE
 * @author        Rodolfo Melogli
 * @compatible    WooCommerce 3.5.7
 * @community     https://businessbloomer.com/club/

add_filter( 'woocommerce_upsell_display_args', 'bbloomer_change_number_related_products', 9999 );

function bbloomer_change_number_related_products( $args ) {
	$args['posts_per_page'] = 2;
	$args['columns'] = 2; 
	return $args;

PHP Snippet 3: Remove Default Elements From Product Upsells Output e.g. Add to Cart @ Single Product Page

 * @snippet       Remove upsells Add to Cart - WooCommerce Single Product
 * @how-to        Get CustomizeWoo.com FREE
 * @author        Rodolfo Melogli
 * @compatible    WooCommerce 3.5.7
 * @community     https://businessbloomer.com/club/

add_action( 'woocommerce_before_shop_loop_item', 'bbloomer_customize_single_upsells' );

function bbloomer_customize_single_upsells() {
	global $woocommerce_loop;
	if ( $woocommerce_loop['name'] == 'up-sells' ) {
		// remove add to cart button
		remove_action( 'woocommerce_after_shop_loop_item', 'woocommerce_template_loop_add_to_cart', 10 );

Where to add custom code?

You should place custom PHP in functions.php and custom CSS in style.css of your child theme: where to place WooCommerce customization?

This code still works, unless you report otherwise. To exclude conflicts, temporarily switch to the Storefront theme, disable all plugins except WooCommerce, and test the snippet again: WooCommerce troubleshooting 101

Related content

  • WooCommerce Visual Hook Guide: Single Product Page
    Here’s a visual hook guide for the WooCommerce Single Product Page. This is part of my “Visual Hook Guide Series“, through which you can find WooCommerce hooks quickly and easily by seeing their actual locations (and you can copy/paste). If you like this guide and it’s helpful to you, let me know in the comments! […]
  • WooCommerce: Disable Variable Product Price Range $$$-$$$
    You may want to disable the WooCommerce variable product price range which usually looks like $100-$999 when variations have different prices (min $100 and max $999 in this case). With this snippet you will be able to hide the highest price, and add a “From: ” prefix in front of the minimum price. At the […]
  • WooCommerce: Hide Price & Add to Cart for Logged Out Users
    You may want to force users to login in order to see prices and add products to cart. That means you must hide add to cart buttons and prices on the Shop and Single Product pages when a user is logged out. All you need is pasting the following code in your functions.php (please note: […]
  • WooCommerce: Add Custom Field to Product Variations
    Adding and displaying custom fields on WooCommerce products is quite simple. For example, you can add a “RRP/MSRP” field to a product, or maybe use ACF and display its value on the single product page. Easy, yes. Unfortunately, the above only applies to “simple” products without variations (or the parent product if it’s a variable […]
  • WooCommerce: Show Number Of Products Sold @ Product Page
    WooCommerce database already stores the number of products sold for you. Therefore, you may want to show such number on the product page, close to the Add To Cart button. As we’ve seen in my book Ecommerce and Beyond, showing the number of sales for each product can increase your sales conversion rate. All you […]

Rodolfo Melogli

Business Bloomer Founder

Author, WooCommerce expert and WordCamp speaker, Rodolfo has worked as an independent WooCommerce freelancer since 2011. His goal is to help entrepreneurs and developers overcome their WooCommerce nightmares. Rodolfo loves travelling, chasing tennis & soccer balls and, of course, wood fired oven pizza. Follow @rmelogli

14 thoughts on “WooCommerce: Move & Customize Upsells @ Single Product

  1. These codes work great but I want to move it above the add to cart button, where do I need to change it?

    1. Change “39” with something lower

  2. Hi Rodolfo! Thank you for the useful post.

    However the first snippet

    remove_action('woocommerce_after_single_product_summary', 'woocommerce_upsell_display', 15);

    doesn’t work. It just doesn’t remove the upsell products from the page.
    I’m using WordPress 6.1.1, Storefront 4.2.0 and WooCommerce 7.4.0

    Do you know what could be the issue?

    Thank you

    1. Hey Paul, it could be your theme (they’re probably already removing it and placing it somewhere else, so you need to adapt the code and remove it from the new position)

      1. Thanks for the answer, but I don’t quite understand what you mean by “they are already removing it”. I’m using usual Storefront theme and it’s child theme. There are no other places in my child theme where such a removal occurs.

        Can you explain a little bit better?

        Thank you

        1. Hey Paul! I tested this snippet with the Storefront theme, so it works and it still does. It must be something else – maybe another plugin?

  3. This was a great deal on figuring out some things.
    Just something that i came across when i used

    $woocommerce_loop['name'] == 'up-sells'

    . Can this loop create a big Database overload if it is used inside an if statement, that adds a weight table inside the single product page?

    1. Great! No, there is no DB involvement here.

  4. I’ve tried it on my site but it did nothing tho

  5. It may be our theme (Shoptimizer for Commercegurus) but the code to move the upsells just duplicates it.

    I had the same problem with one of your other similar snippets.

    1. Hi Sean, Shoptimizer support is great, I’m sure they’ll help you with this

  6. Looking for a code/shortcode to put upsells in a sidebar – would you know how to do that?

    1. Hello Lauren, thanks so much for your comment! Yes, this is definitely possible, but I’m afraid it’s custom work. If you’d like to get a quote, feel free to contact me here. Thanks a lot for your understanding!

Questions? Feedback? Customization? Leave your comment now!

If you are writing code, please wrap it like so: [php]code_here[/php]. Failure to complying with this, as well as going off topic or not using the English language will result in comment disapproval. You should expect a reply in about 2 weeks - this is a popular blog but I need to get paid work done first. Please consider joining the Business Bloomer Club to get quick WooCommerce support. Thank you!

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