WooCommerce - get category for product page

WooCommerce - get category for product page

  1. Blog
  2. 15 November 2026
  3. 3 min read

Stefan Bogdanescu

Founder & Senior Architect

Retrieving WooCommerce Category IDs for Custom Body Classes

When developing custom styling for WooCommerce product pages, a common requirement is to assign specific CSS classes to the <body> tag based on the active category. This approach allows you to override global styles without duplicating code across multiple stylesheet files. The standard pattern involves hooking into the body_class filter within the theme's functions.php file or a custom plugin.

The typical implementation looks like this:

if ( is_product() ) {
    add_filter( 'body_class', 'my_add_woo_cat_class' );
}

function my_add_woo_cat_class( $classes ) {
    // Logic to find the category ID goes here
    $wooCatId = ???; 
    
    if ( ! empty( $wooCatId ) ) {
        $classes[] = 'my-woo-cat-id-' . $wooCatId;
    }

    return $classes;
}

The critical gap in this snippet is determining how to retrieve the active category ID. Unlike standard WordPress categories where get_the_category() might suffice, WooCommerce products operate within a specific context that requires careful handling. You are not simply looking for any category associated with the post type; you need the specific term IDs assigned to the currently displayed product.

The most reliable method involves utilizing the product data directly. The global $product object is available on single product pages, but relying on globals can sometimes lead to scope issues or unexpected behavior if not handled within a function context that explicitly references the current post ID. A more robust approach is to use wc_get_product() or get_the_ID() combined with the wc_get_product_category_ids() function.

Here is the corrected implementation:

function my_add_woo_cat_class( $classes ) {
    if ( ! is_product() ) {
        return $classes;
    }

    // Retrieve the product object for the current page
    $product = wc_get_product( get_the_ID() );

    // Get category IDs. This returns an array of term IDs.
    $category_ids = $product->get_category_ids();

    // Check if categories exist before adding classes
    if ( ! empty( $category_ids ) ) {
        foreach ( $category_ids as $cat_id ) {
            // Generate the class name using the category ID
            $classes[] = 'my-woo-cat-id-' . $cat_id;
            
            // Optional: You might want to limit this to the first category 
            // or specific categories depending on your design requirements.
        }
    }

    return $classes;
}

add_filter( 'body_class', 'my_add_woo_cat_class' );

Handling Multi-Categories and Term Hierarchies

WooCommerce products can belong to multiple categories simultaneously. The method $product->get_category_ids() returns an array containing all associated term IDs. If your styling strategy requires applying a class for every category, the loop provided above handles this correctly. However, if you only intend to style based on the primary or top-level category, you would need to filter that array against wc_get_product_terms().

Performance Considerations

One potential pitfall in the original logic was the assumption that the category ID could be retrieved without loading the full product object. While get_the_ID() gives you the post ID, converting that to a WC Product object is necessary to access category relationships reliably. This adds a small overhead on every page load where the filter is active.

If you are building a large store and performance is a primary concern, ensure that your theme does not rely on this logic for non-product pages. The is_product() conditional check at the start of the function mitigates most issues, but be aware that any custom CSS targeting these classes will only apply when a specific product category is active.

Troubleshooting Missing Categories

If you find that the classes are not being added despite correct syntax, verify that the body_class filter is actually firing. You can temporarily echo the $classes array before returning it to inspect its contents:

var_dump( $classes ); // Debugging output

Additionally, ensure that no parent theme or plugin is overriding the default body classes in a way that conflicts with your additions. While this approach works well for static styling, dynamic loading of CSS based on these classes should be handled carefully to avoid layout shifts.

Our network