Description
Category Description for WooCommerce allows WooCommerce store owners to customize how product category descriptions are displayed.
With advanced options for positioning and formatting, you can better showcase your products and improve SEO optimization.
Key Features:
– Add custom descriptions for each product category.
– Position descriptions:
– Above products (full text or excerpt).
– Below products.
– Combine positions with full and excerpt views.
– Use a “Load More” button to expand excerpted descriptions.
– Seamless integration with block-based (FSE) and classic themes.
– Avoid duplicate content with customizable display options.
– Edit descriptions easily with the WordPress editor.
– Use the [cdfwsp_split] marker to define an exact split point in the description, overriding the word limit.
– Use the [cdfwsp_category_description] shortcode to display descriptions anywhere: page builders, custom templates, or theme files.
Why Choose This Plugin?
Enhance user experience and SEO by having full control over the display of your WooCommerce product category descriptions.
This plugin is lightweight, easy to use, and works seamlessly with most WordPress themes.
Shortcode Reference
[cdfwsp_category_description]
Display a product category description anywhere on your site — page builders, custom templates, or theme files. Works independently of the admin Display Option setting.
Attributes
part (default: full)
Controls which part of the description to output:
full— complete description ([cdfwsp_split]marker stripped from output).excerpt— excerpt part only (before the split point or word limit).rest— remainder part only (after the split point). Renders with a targetable anchoridfor use withexcerpt_anchor.excerpt_toggle— excerpt with a Load More button that reveals the full description. JavaScript is loaded automatically.excerpt_anchor— excerpt with an anchor link pointing to apart="rest"shortcode placed elsewhere on the page. No JavaScript required.
id (optional)
Product category ID. Takes priority over slug.
slug (optional)
Product category slug. Used when id is not set.
If neither id nor slug is provided, the shortcode auto-detects the category from the current archive page.
Examples
Display the full description on the current archive page:
[cdfwsp_category_description]
Excerpt with a Load More button on the current archive page:
[cdfwsp_category_description part="excerpt_toggle"]
Excerpt with a Load More button for a specific category:
[cdfwsp_category_description part="excerpt_toggle" slug="clothing"]
Split view — excerpt above products, full text below (no JavaScript):
[cdfwsp_category_description part="excerpt_anchor"] (place above products)
[cdfwsp_category_description part="rest"] (place below products)<h3>Support</h3>
If you have any questions, issues, or suggestions, please post them on the WordPress.org support forum.
Screenshots
Installation
- Download and install the plugin directly from the WordPress.org repository, or upload it through the WordPress admin panel.
- Activate the plugin.
- Edit product category descriptions through the WooCommerce products categories admin screen.
- Configure settings for description display as needed.
FAQ
-
Does this plugin work with any WooCommerce theme?
-
Yes, the plugin is designed to work with all WooCommerce-compatible themes, including block-based (FSE) and classic themes.
-
Can I use this plugin to improve my SEO?
-
By customizing category descriptions, you can add unique and relevant content that improves search engine visibility.
-
Does this plugin affect website performance?
-
No, the plugin is lightweight and optimized to ensure minimal impact on performance.
-
Is the plugin translation-ready?
-
Yes, the plugin is fully translation-ready.
Reviews
Contributors & Developers
“Category Description for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Category Description for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.0
- Fix: load_plugin_textdomain() called with incorrect first argument — translations were not loading.
- Fix: sanitize_callback in register_meta() referenced non-existent method name.
- Fix: Trailing space in nonce hidden field value.
- Fix: Unclosed div#bottom_text in above_excerpt_below_full display mode.
- Fix: Asset version now uses plugin version constant instead of hardcoded string.
- Fix: Missing current_user_can() authorization check in save_category_fields().
- Fix: display_option field now validated against allowed values (whitelist).
- Fix: REST API schema now lists correct display_option enum values.
- Fix: above_products_full display mode now respects FSE vs. classic theme hook position, consistent with other display options.
- Fix: Word Limit fallback now correctly compares against word count.
- Fix: Load More text splitting now uses substr() to prevent text corruption when excerpt text appears multiple times in the description.
- Fix: Multiple [cdfwsp_category_description part=”excerpt_toggle”] shortcodes on the same page now all work independently.
- Feature: Added
[cdfwsp_split]marker — place it anywhere in the category description to define the exact split point for Load More and “Above + Below” display options. The marker takes priority over the Word Limit setting and is never visible to visitors. - Feature: Added
[cdfwsp_category_description]shortcode — display the category description anywhere: page builders, custom templates, or theme files. Supports full, excerpt, rest, excerpt_toggle, and excerpt_anchor output parts.
1.0.0
- Initial release.

