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        businessbloomer.com/woocommerce-customization
 * @author        Rodolfo Melogli, Business Bloomer
 * @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        businessbloomer.com/woocommerce-customization
 * @author        Rodolfo Melogli, Business Bloomer
 * @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        businessbloomer.com/woocommerce-customization
 * @author        Rodolfo Melogli, Business Bloomer
 * @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

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

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

  1. Hello,

    on recent projects I am working with full site editing themes. After some trial and error I realized that all product page hooks I was working with so far are not working anymore. Am I right? So e.g. the here provided add_action( ‘woocommerce_single_product_summary’, ‘woocommerce_upsell_display’, 39 ); has no effect. I am also not able find any corresponding block element to output upsell products (similar to the Related Products block). What is your experience so far with full site editing and woocommerce? And do you have any suggestion on how to add upsell products to the product detail page?

    1. FSE = not good for developers as there are no PHP hooks as of now.

      However, I’m starting to publish some workarounds within my visual hook guides, and within the end of July 2024 you should get the one for the Single Product page as well.

      Hope this helps

  2. 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

  3. 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?

  4. 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.

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

  6. 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

  7. 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 *