WooCommerce: Deny Checkout Based on Cart Weight

A WooCommerca fan asked this question on a Facebook group, so I had to write a snippet about it: “How do you deny checkout if the cart weight is above a certain threshold?“. Well, this is straight forward, so there you go!

WooCommerce: show checkout error if weight exceeds a threshold

PHP Snippet: Deny WooCommerce Checkout Processing if Cart Weight > Threshold

 * @snippet       Deny Checkout Based on Cart Weight - WooCommerce
 * @how-to        Watch tutorial @ https://businessbloomer.com/?p=19055
 * @sourcecode    https://businessbloomer.com/?p=21748
 * @author        Rodolfo Melogli
 * @compatible    WC 2.6.14, WP 4.7.2, PHP 5.5.9

add_action('woocommerce_after_checkout_validation', 'bbloomer_deny_checkout_if_weight');

function bbloomer_deny_checkout_if_weight( $posted ) {
global $woocommerce;
$max_weight = 100;
if ( $woocommerce->cart->cart_contents_weight > $max_weight ) {
   $notice = 'Sorry, your cart has exceeded the maximum allowed weight of ' . $max_weight . get_option('woocommerce_weight_unit');
   wc_add_notice( $notice, 'error' );

Where to add this code?

You can place PHP snippets at the bottom of your child theme functions.php file (before "?>" if you have it). CSS, on the other hand, goes in your child theme style.css file. Make sure you know what you are doing when editing such delicate files - if you need more guidance, please take a look at my free WooCommerce Customization video tutorial.

Does this snippet still work?

Please let me know in the comments if everything worked as expected. I would be happy to revise the snippet if you report otherwise (please provide screenshots). I have tested this code with Storefront theme, the WooCommerce version listed above and a WordPress-friendly hosting on PHP 7.

If you think this code saved you time & money, please join other Business Bloomer supporters and avail of 365 days of WooCommerce benefits. Thank you in advance :)

Need Help with WooCommerce?

Check out these free videos, tutorials and tips!

  • how-to-edit-woocommerce-with-php-snippets
  • woocommerce-hooks-add_action-list-visual
  • woocommerce-customize-single-product-page-PHP
  • woocommerce-customize-shop-page-PHP
  • woocommerce-advanced-customization
  • how-to-edit-woocommerce-cart
  • woocommerce-customize-checkout-page-PHP
  • woocommerce-email-customization
  • woocommerce-conditional-logic

Rodolfo Melogli

Author, WooCommerce expert, WordCamp speaker and Internet marketer, Rodolfo Melogli has worked as a WooCommerce freelancer since 2011. He helps entrepreneurs and developers overcome their WooCommerce nightmares :) Rodolfo is the organiser of WordCamp Dublin, the Dublin WooCommerce Meetup, the Dublin Ecommerce Meetup and the Dublin WordPress Meetup. He enjoys interacting with people, travelling and chasing tennis & soccer balls. Of course, he loves pizza too.

3 thoughts on “WooCommerce: Deny Checkout Based on Cart Weight

  1. Awesome Snippet ๐Ÿ™‚

    I want to ask if there any way this will only show up for a regular customer, I have the wholesale plugin for WooCommerce and I don’t want that notice for that user role.

    Thanks a lot for sharing this with the community.

    1. James – thanks so much for your comment! Yes, this is possible – but unfortunately this is custom work and I cannot provide a complementary solution here via the blog comments. If you’d like to get a quote, feel free to contact me here. Thanks a lot for your understanding! ~R

  2. […] up from the other day’s snippet (deny checkout based on cart weight), you might want to show what is the current Cart Weight on the cart and checkout page. So here you […]

Questions? Feedback? Support? Leave your Comment Now!
If you are writing code, please wrap it between: [php]code_here[/php]. Failure to complying with this (as well as going off topic) will result in comment deletion. You should expect a reply in about a week - this is a popular blog but I need to get paid work done first. Please consider joining #BloomerArmada to ask me 1-to-1 WooCommerce questions. Thank you :)

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

This site uses Akismet to reduce spam. Learn how your comment data is processed.