WooCommerce: Exclude Category from ‘products’ Shortcode

The WooCommerce [products] shortcode displays all products in your shop. There is even an attribute called “category” where you can specify comma-separated list of category slugs in order to further filter the output.

What you can’t do is define a list of unwanted categories (think of “uncategorized” for example) i.e. a list of categories you want to exclude from the products shortcode output.

So, here’s the fix, enjoy!

WooCommerce: exclude category from shortcodes
WooCommerce: exclude category from shortcodes

PHP Snippet: Exclude Category from “products” Shortcode

Let’s say we want to remove the category “black” (see above example) from the “products” shortcode. The snippet to place in your functions.php is very simple:

/**
 * @snippet       Exclude Category from products Shortcode
 * @how-to        Get CustomizeWoo.com FREE
 * @author        Rodolfo Melogli
 * @compatible    WooCommerce 6
 * @community     https://businessbloomer.com/club/
 */

add_filter( 'woocommerce_shortcode_products_query', 'bbloomer_exclude_cat_shortcodes' );
 
function bbloomer_exclude_cat_shortcodes( $query_args ){ 
	$query_args['tax_query'][] = array( array( 
		'taxonomy' => 'product_cat', 
		'field' => 'slug', 
		'terms' => array( 'black' ), // Don't display products from this category
		'operator' => 'NOT IN'
	)); 
	return $query_args;
}

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: Display All Products Purchased by User
    When a WooCommerce customer is logged in, you might want to show them the list of previously purchased products (maybe in a custom “My Account” tab). This is helpful when customers tend to buy the same products over and over again, and therefore you can help them “order again” without having them to search the […]
  • WooCommerce: Display Out of Stock Products (Shortcode)
    A client of mine wanted to show out of stock products on a separate page – so I coded a simple shortcode for you all! You can use this shortcode for different goals. For example, you might want to display what products you’ve sold to enhance customer trust / social proof. So let’s see (1) […]
  • WooCommerce: Recently Viewed Products (Shortcode)
    Currently, you can use a widget or a block to have the user see the list of products they recently viewed. But for now, let’s create our own shortcode… and let’s take advantage of the existing Business Bloomer ClubRated 5.00 out of 5 $29.00 – $999.00 /once Whether you’re only starting with WooCommerce or you’re […]
  • WooCommerce: Exclude Category from ‘product_categories’ Shortcode
    Sometimes solutions are very simple, and you don’t need rocket science to fix your issue! A client of mine needed to hide a category from the Product Categories Shortcode ( BloomerArmada (1) Online Courses (1) WooCommerce Mini-Plugins (30) ); in fact, there is no parameter that allows you to “exclude” a given product category such […]
  • WooCommerce: Display Product Reviews @ Custom Page (Shortcode)
    WooCommerce product reviews shows by default in the “Reviews” tab in the single product page. But what if, like me, you’re using custom sales pages and need to show such reviews elsewhere – by using a shortcode? I’ve spent some time doing this for two Business Bloomer pages, the contact page (beside the request a […]

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

17 thoughts on “WooCommerce: Exclude Category from ‘products’ Shortcode

  1. It removes the specific categories form the products shortcode, but it does not bring the products specified in the “category” parameter of the shortcode. It brings any product from the shop that is not in the categories specified in this snippet, so it makes all shortcodes return the same products in the end.

    How can this be used to filter out products form a specific category, but still bring just the products from the category specified on “category” parameter of the shortcode?

    Thank you

    1. You’re 100% right! Check the new version please

  2. Or just use shortcode like this:

    [products category="my-category-slug" cat_operator="NOT IN"]

  3. Snippet dont work width brocket filter plugin. πŸ™
    but tnx πŸ™‚ for the snippet, it was almost perfect πŸ™‚

    1. Ok

  4. Thanks a lot !
    This snippet helped me to make mine work when I know almost nothing about PHP. I give it to you bellow here if it helps anyone. My snippet retrieves the current category to display the shortcode [products] with the products of the category being viewed (usefull if I want to display the on_sale products of each category visited for example).
    Ideally, this should be added:
    – a condition not to apply if the category is already specified in the shortcode parameters
    – and in this case, if the shortcode parameter entered is category=”’, then all products of all categories are displayed.
    But I don’t know how to do that yet.

    add_filter( 'woocommerce_shortcode_products_query' , 'current_category_products_shortcode');
    
    function current_category_products_shortcode($query_args){
     	$cat_archive = get_queried_object();
    	$cat_archive_slug = $cat_archive->slug;
        $query_args['tax_query'] =  array(array( 
                'taxonomy' => 'product_cat', 
                'field' => 'slug', 
                'terms' => $cat_archive_slug,
                'operator' => 'IN'
            )); 
     
        return $query_args;
    }
    
    1. It needs also a conditional logic to apply only on category and tag pages. Don’t use as is.

      1. Didier, 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!

  5. Great! Worked.

    Now one thing left, how to exclude specific categories in the Top rated products widget?

    1. Hello Christiaan, 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

  6. Hello,

    It works with WooCommerce 3.3.1, Thank you so much, your solution saved me loads of time. πŸ™‚

  7. Great function! How would I exclude 2 or multiple categories? Thanks!

    1. Hey Bobby, thanks so much for your comment! You’d add categories here:

      array('black','red','white','etc'),
      
  8. Thank you Rodolfo for sharing your knowldege
    I have a question, Can we make pages for each category by excluding the others categories or what would be the best approach to achive that?

    1. Hey Vale, thanks for your comment! You already have those pages by default, go to Products > Categories and you can access them.

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 *