Rich Text Tag, Category, and Taxonomy Descriptions for WordPress

Rich Text Tags Plugin on

Taxonomies, baby!The Rich Text Tags plugin allows you to use the WYSIWYG TinyMCE text editor (the WordPress default editor) while editing Categories, Tags, and taxonomies (custom categorization created by the Yoast Simple Taxonomies plugin).

Adding Category & Tag descriptions

There’s plenty of information online on how to add category descriptions and tag descriptions to your theme. WordPress has built-in functionality for those:

How to add the taxonomy title & descriptions to your theme

Once you have the cool new rich text editor, you’ll feel pretty silly if you don’t put that great content in your theme.  So here’s what to do:  add the following snippet of code into your archive.php file.

if(isset($wp_taxonomies)) {
	// This is getting the friendly version of a taxonomy
	// - not the hyphenated get_yoast_term_title()
	$term = get_term_by( 'slug', get_query_var( 'term' ), get_query_var( 'taxonomy' ) );
	if($term) {
		echo '<h2 class="pagetitle">'.$term->name.'</h2>';
	// If you have a taxonomy description, let'er rip!
	if(function_exists('get_yoast_term_description') && get_yoast_term_description()) {
		echo wptexturize(get_yoast_term_description());

Using this code, you can now have custom content on your taxonomy pages, like this one for Andersen Windows.

SEO Benefits of this plugin

Besides the obvious benefits of giving users more information on your archive pages, there are intrinsic SEO benefits to having tag, category, and taxonomy descriptions.

When you have tags and categories where posts overlap, it’s a good idea to try to create as much unique content on each page as possible, so that each page gets indexed by Google. Having custom content for each page will do that.

Help me help you!

Please leave any issues you have with the plugin in the comments below. I like to squash code bugs!

Known Plugin Incompatibilities

This plugin does not work with these plugins:

  • David

    Zack- Very cool plugin. By chance I was searching Google for a plugin that could do this and stumbled upon yours. Nice!

    Any chance you can incorporate the image uploader into the editor? If that’s possible, I’d definitely use that feature!


    • Zack Katz

      Hi David – I wanted to do that in the first version, but I didn’t have the time. This feature will definitely be in future versions…though I can’t say when.

    • Zack Katz

      Yeah, as suspected, it’s hard…If you can figure out how, let me know!

  • AU Web Designer

    Same as David, thanks heaps! I’ll give it a try too and might get back if I figure it out.

  • Zack Katz

    Version 1.0.3 is completed and now includes the media uploader & media library functionality!

  • Karen

    Help! I am using Thesis with open hook and when I enter the code you give to to my archives.php page to allow my category descriptions to appear on my site like the Anderson Windows example it doesn’t work.

    Any idea what I could be doing wrong?

  • Pingback: Wtyczki – Dexter | NucleON IT Business Services – Test Site()

  • Damiano

    Hi! Great plugin, but seems that category_description() strips the html tags out from descriptions… Any hints? I’m using WordPress 2.9. Thank you however!

    • Zack Katz

      Hi Damiano, that should have been taking care of automatically when using the plugin…but you can always try adding the same code again to your functions.php file:

      remove_filter( 'pre_term_description', 'wp_filter_kses' );

      • Damiano

        adding that string doesn’t work, at least for <li> and <img> image… I also upgraded to WordPress 2.9.1. If I’ll find something useful, I’ll posti it here.

        • Richard

          To allow images you need to add this to the functions file
          <code>remove_filter( ‘term_description’, ‘wp_kses_data’ );
          remove_filter( ‘pre_term_description’, ‘wp_filter_kses’ ); /*added to allow tag images and html*/ </code> I use it and it works on 2.9.2

  • Sjoerd

    Did you already find a solution for the problem with the <li> and <img> tags? I’ve used allot of lists in my tag descriptions and WP strips them all.. :S

  • JHouse

    Very cool plugin. I got it working partially, but I couldn’t separate the text into paragraphs. Well, I could in the editor, but it wouldn’t show on the main site. I added the function code you provided as well, but no dice. Also, every time I added pasted text (I was working on text in a text editor), it would oddly add it twice. Any thoughts as to what’s causing this?

  • Scot Hacker

    This plugin isn’t stripping out the IMG tags – you can save and then view source to confirm that your image paths are still there. The problem is that as of WP 2.9, the WP category_description function strips out IMG and other tags.
    The fix is here, and it’s simple:
    Nutshell: Just use this in your archive.php template instead:
    $category = get_the_category();
    echo $category[0]->category_description;

  • Scot Hacker

    Ack – paragraph breaks are being stripped out in 2.9.1 (like JHouse says above). This is a show stopper.
    The other plugin with similar functionality:
    doesn’t have this problem, but it doesn’t allow direct media upload like yours does. If only the bugs in these two plugins would cancel each other out…

  • Michael

    Good Job.
    The plugin very useful.
    Now I have a question:
    When i use it, the <H1> does not work.
    Can you check the url:

    All about Google.

    the website is like this.
    but in the admin, it is this

    All about Google.

    Thank you very much.


    • Zack Katz

      This is fixed in version 1.1.

  • Michael

    the last comment,
    GoogleAll about Google.
    the first Google should be in <h1>, in the comment, it doesn’t work.

  • Matt Halfhill

    Thank you for the informative post and great plugin!

    I was wondering if you know how to echo images, links, and other html with the tag_description(); ? I use the Rich Text Tag plugin so that I can easily add in images and links, but when I make the echo call, it strips these out.

    I am using WP 3.0 and heard that 2.9 was a party pooper with alot of things, but is there a hack around this?

    Much thanks!

    • Zack Katz

      This should now be fixed in version 1.1.

  • Rob

    Hi – The uploader is not showing above the category description. Any idea why that may happen?

    • Zack Katz

      This should now be fixed in version 1.1, just released.

  • Christine

    I added these 2 lines to my functions, which is allowing for classes and styles and images.
    remove_filter( ‘term_description’, ‘wp_kses_data’ );
    remove_filter( ‘pre_term_description’, ‘wp_filter_kses’ );

    However, I’m having some issues with images. When in the lightbox with images in gallery, it won’t allow me to “Insert into Post” is this simply because it’s not a post? Also, it’s not allowing for captions. It’s spitting out the tags used, but in the Visual view it shows the caption.
    [caption id="" align="alignright" width="215" caption="This is what caption copy looks like."] [/caption] Do captions not work?

    Thanks for your help,

  • Christine

    My example caption copy, above, turned into a caption…haha, basically it’s not doing that in my Taxonomy Description. Did I mention this is a description for Custom Taxonomies? Maybe that’s an issue as well.

    Thanks again!

    • Zack Katz

      I just released version 1.1. Please let me know if that fixes the problem.

  • Nabha

    Hi Zack,

    These seems to work great, except for one bug we’re having with it: paragraphs and line breaks are being stripped out of the HTML.

    It’s easily reproducible:

    1. Add a few paragraphs of text using the rich text editor, with a custom taxonomy attached to a custom post type in WordPress 3.0.1
    2. Toggle between code view and rich text view once or twice. You should lose the line breaks immediately

    Also, I seem to lose the line breaks without toggling — all I have to do is save the description. When I return to that description-editing-page later, the line breaks are gone.

    Whatcha think? I’m happy to help debug.


    • Daniel

      the same problem. remove_filter( ‘pre_term_description’, ‘wpautop’ );
      helping to prevent on-load filtering, but nothing more about toggling and saving.

    • Zack Katz

      This issue has been fixed with version 1.2. Thanks for reporting it.

  • Blueman

    Great stuff, any chance this can work on a page not an archive within a custom loop?

    • Zack Katz

      Not sure I understand what you’re suggesting…please clarify

  • DL

    Is there any way to hide or truncate the description from the right hand list of categories on the summary / create page in wp-admin? My category descriptions are extremely long making this list a whole lot less usable (and ugly).

    • Zack Katz

      I just implemented your idea on version 1.3.1 – thanks for your comment!

  • MTS

    Hey, I love your plugin!

  • MTS

    Hi, I love your plugin! I am running into a small problem — not sure if it’s a bug or something on my end.

    When I add links in the Rich Text Editor, I notice that it adds additional quotes in the HREF attribute. Not only that, when I go through and clean up the errors, it seems to put them back in. I’m constantly having to repair this. Any thoughts on what might be causing it?

    Thanks again!

  • Pickup

    Thank You for your plugin! It’s great.

    But some problem.. In HTML-editor i put tag (for russian SE yandex), and it had cutted, when i save my post. Can you help me?

  • Daniele

    Hi! Great plugin, thanks for you work!
    Btw, I have a question: I can add some tags as , , code view, etc to the editor?

  • JL

    FYI – on WordPress 3.1, you can’t create links using TinyMCE. Clicking the link button does nothing. :/

    • Jonas

      I have the same problem. It’s still possible to create links in regular posts…

  • Swisss

    The plugin is working great on existing product categories but generates errors when trying to create new product categories.

    Error message when trying to view any new product categories:

    Catchable fatal error: Object of class WP_Error could not be converted to string in /home/xxxxx/public_html/wp-content/themes/rttheme11/functions/rt_breadcrumb.php on line 78

  • Anonymous

    This is a great idea. I’m running WP 3.1.3 on a multisite installation in a child theme of Twenty Ten and for some reason the rich taxonomy descriptions just won’t show up. Hope you can advise! Thanks you.

  • Pingback: Herramientas útiles para CMS Multisitio | Autonotel()

  • Richard

    Have an error on activation:
    Warning: call_user_func_array() []: First argument is expected to be a valid callback, ‘wp_tiny_mce_preload_dialogs’ was given in /xxx/public_html/wp-includes/plugin.php on line 405

    • Madla

      I’ve got the same problem…in WP 3.2.1. It still seems to work though…

    • Zack Katz

      This was fixed, by the way.

  • Gasonmark

    WordPress 3.2.1, Rich Text Tags 1.3.3, wp-e-commerce 3.8.6

    I am using the WP-e-commerce plugin for an online shop, test site here
    I have installed the plugin, it definitely affects the descriptions for the product categories, I can do lists and align right  etc, BUT I can not do line/paragraph breaks. I read here this was fixed.
    All I have done is install Rich Text plugin, I have not installed Yoast Simple Taxonomies plugin or changed any PHPShould I have to add Yoast or any code to my theme to make breaks work in my theme?Hope someone can help get me goingI think this piece of code in wpsc-grid_view.php is what displays the description. grid view is the layout of the category page

  • Gasonmark

    So you can not put PHP code here, I kind of guessed as much. So the end of my last comment is missing some vital info!! The code is posted here..

  • Zack Tollman

    Zack…great plugin. Seems the issue regarding the missing paragraph breaks is still a problem. I’m running the latest version of the plugin. It saved breaks correctly, but the problem is that when I view the description in the editor, the breaks are missing. If I save the description without putting the breaks back in, I lose all of the breaks.

    Any idea how to remedy this?

    • socialblogsite

      I found this happening even without this plugin. In my case there was another editor open in ANOTHER browser tab stuck in “loading”, and once I closed that tab, all the other scripts (editor related javascript) in the other browser tabs started working.

  • Zack Tollman

    Zack…great plugin. Seems the issue regarding the missing paragraph breaks is still a problem. I’m running the latest version of the plugin. It saved breaks correctly, but the problem is that when I view the description in the editor, the breaks are missing. If I save the description without putting the breaks back in, I lose all of the breaks.

    Any idea how to remedy this?

    • Chris

      I’m losing paragraph breaks as well. Mine aren’t saving at all though, no matter what I do.

    • Tamlyn Rhodes

      There’s a partial solution to this problem on the WP forums

    • Cornwall Guide

      Running WP 3.3.1 and am having problems with this. Is there a definitive fix yet? Thanks

      • Matt

        I too am having trouble with 3.3.1 and this plugin.  It does not display at all in my categories page. See screen shot.  Any idea when a fix will be about?

  • Gasonmark

    I do not even know how I discovered this but when I put my entry in with the rich text editor toggled OFF using the following html, it seems to both give me paragraph breaks and keep them when I save again later, even with the rich text editor ON (which it is by default when you return)
    Here is a whole lot of text in my description. Well there is even more, and more and moreThen we have a second paragraph, seems to work.
    Even a third will be fine, hope this helps folks.

  • Gasonmark

    OK so you can not put HTML in the comments, would be nice if code tags worked here
    so substitute the obvious for ] in the following and it should give you breaks that survive editing as mentioned in my previous post
    [p style=”text-align: left;”]Here is a whole lot of text in my description. Well there is even more, and more and more.[/p][p style=”text-align: left;”]Then we have a second paragraph, seems to work.[/p][p style=”text-align: left;”] Even a third will be fine, hope this helps folks.[/p]

  • MIlano

    It is possible to add category (brand) description below the post (product) content?

  • Smrth

    when can we expect an update for 3.3?

    • Zack Katz

      Version 1.4.1 adds support for 3.3.

      • Smrth

        yeah, already updated yesterday.. thanks a bunch!

  • mgason

    Using woocommerce and abundance theme from Kreisi. WordPress 3.3 Plugin 1.4.1
    When I enter a Category screen, Product or regular WordPress post, I see my list of categories. The section on the left allows creation of a new category. That description text box has a “toggle rich text editor” link. It does nothing. When I select a category to edit. The description text field has no rich text toggle.As I said this also applies to regular wordpress post categories, not just woocommerce ones.
    Any ideas? I am willing to supply a login.
    I have used this plugin with successfully on other sites

  • mgason

    I did some more testing regarding the plugin not showing in my category page. Luckily my client emailed saying love that plugin! He could see it. I coud not.

    I logged in to his site using Firefox, Chrome and Safari. No button in the Category section. I am an Administrator.
    I then logged in using his login and Password. He is also an Administrator. I could see the plugin and use it. What could be different about his profile and mine?We do not have any fancy user management plugins. We  are both Administrators.

    • Zack Katz

      Likely the setting in your WordPress profile “Visual Editor” is disabled? You may not have “rich_text_editing” permissions.

  • mgason

    Thanks for the reply

    No, both Administrator and both profiles have “Disable the visual editor when writing” NOT checked.Weird thing I could always see the Upload/Insert icons for media images etc BUT they were in the top left corner of the page. Today all of the buttons are there everything works fine. I unfortunately have no idea what might have changed. I made a new user, all worked fine. So I will just move on.

    Thanks again for your reply. Sorry I can not point you to a cause.

  • Kevin

    When I go to edit a category discription, the wyiswyg doesn’t show; I only see this:

    Maybe something went broken in the upgrade. Any way to fix this?

  • Kevin

    Here is a screenshot.

  • Justjermaine

    Thank you for a great plugin.

    Just upgraded to 1.4.1 to fix the editor, and it looks better.
    However when I toggle the RTE, paragraphs are stripped, just like they did in older versions.

    Any fix on this coming?

    • Justjermaine

      Extra information: using WP 3.3 and custom taxonomies.

  • Awal

    Any rich text plugin to post from frontend?

  • Brian Combs

    Just upgraded to the latest version, and the shortcodes I had installed are no longer rendering. I use them to pull in some info from WP-Table Reloaded.

    Any thoughts on what I might need to change?

    • Zack Katz

      Thanks for pointing this out. In reworking the code, I forgot to add back the do_shortcode filter.

      I am now uploading Version 1.5.1, which will be available soon.

      • Brian Combs

        Thank you! I like solutions where I don’t have to do anything. :-)

  • Tuqire Hussain


    I have added the plugin to a site I am developing, and although it works fine for standard post categories, the editor and description field do not display for custom taxonomies. Any ideas?

  • Daniele Raimondi

     Wordpress 3.3.2 with RTT 1.6.2

    I’ve found an issue on user profile with your plugin active: the password input fields just disappeared! I can’t change a user password anymore.

    If I deactivate RTT, password input fields are there again.

    Any idea about it?Am I the only one with this problem?

    Thanks in advance.

    • Daniele Raimondi

      thanks for the update. It works great now from 1.6.3 version on.

      • Zack Katz

        Great, glad to hear it.

  • Amy

    I am having trouble with adding links to the category description.  I see the editor and the html and visual seem to be functioning.  However, the link inside of the description is not showing as a link.  It is only showing the anchor text but it is not clickable.

  • pingraham

    Nice plugin.  On the HTML tab in Edit mode, the control buttons are stacked one on top of the other.  Each button is the full width of the editor.  Is there a way to make them go across the top like they do in the wysiwyg “post” editor.

  • Aadi


    I have setup a taxonomy and using The rich text editor for the
    description. When I try to add a new image using the Add Media dialog,
    the image isn’t added to the description after the text?

    Please see screenshots at

    Any help will be great.


    • Zack Katz

      What happens when you place your cursor in the text field first?

  • Pingback: Jakich wtyczek używam do wordpressa | Sekrety stron www()

  • Gigio

    I suggest to add a strip_tags on except generator because, in my case, it doesn’t remove images:

    return strip_tags(apply_filters(‘wp_trim_term_excerpt’, force_balance_tags($text), $raw_excerpt));

  • WisTex

    What if your theme does not have an archive.php file?

  • Alexandr Sokol


    On my local installation of WP 3.5.1 on the page

    appears the following:

    Undefined variable: css in
    on line 168

    And thanx for pretty cool plugin.

  • anou

    I don’t find any trace of my previous post… I was just saying that I didd a patch for your rich text tag plugin for i18n… if you want it I’ll be glad to send it to you.

    • Zack Katz

      Yes, please send it to

  • Friv

    another excellent one :)

  • CD

    hi, I activated your plugin rich-text-tags and then added this code to the archive.php of my WP theme. Now my categories have crashed, i.e. whenever I click on any category on my website, it gives me an error. This is my website: I have removed the plugin, I removed the code from my archive.php too, but it’s still not allowing me to access the categories. Kindly assist me in this. Thanks.


    if(isset($wp_taxonomies)) {
    // This is getting the friendly version of a taxonomy
    // – not the hyphenated get_yoast_term_title()
    $term = get_term_by( 'slug', get_query_var( 'term' ), get_query_var( 'taxonomy' ) );
    if($term) {
    echo '’.$term->name.”;
    // If you have a taxonomy description, let’er rip!
    if(function_exists(‘get_yoast_term_description’) && get_yoast_term_description()) {
    echo wptexturize(get_yoast_term_description());

  • Alessandro Pivaro

    Hi, I’m running WP 3.6 and i have a problem with this plugin.
    If I insert an image using the media upload button, the category description is no more editable.
    If i try to edit a category description with an image in it, I get an empty RTE windows.
    The HTML of the descritpion is in the page ( I can see it in the code) but is not loaded into the RTE window!

    • socialblogsite

      Same happens to me. Empty visual and text editor. The content was uploaded fine in the main categories window, but once you open them in their own editor, the editors are empty. The original box does have the content. You can see it quickly flashing until the javascript adds the new editor. But the info is not passed to the new editor.

  • Christine

    I’m experiencing a couple bugs on WordPress 3.8.1 with RTT 1.7.3. The biggest issue is that when there is any white space at the end of a taxonomy description, the editor will not display it for editing. You can overwrite it by putting in new content, but you cannot edit a description you’ve already saved in that case.

    There is also an issue with the display of the taxonomy term listing in the admin. It looks like there’s some malformed html, it’s all garbled. I noticed one of the description excerpts stopped right in the middle of an attribute, I think they’re the issue. When the plugin is deactivated, the formatting is fine.

    Thank you so much for your continued work on this plugin.

  • Sven Wagener

    At first: Thank you for the great Plugin!

    I found a Bug on the overview pages. If there is HTML and it is cutted in the overview, the whole term site will be not displayed correct. I solved the problem by Adding the following function:

    function kill_term_desc_html( $terms ){

    foreach ( $terms AS $key => $term ):
    $term->description = strip_tags( $term->description );
    $terms[ $key ] = $term;

    return $terms;
    add_filter( ‘get_terms’, ‘kill_term_desc_html’ );

  • Rikard

    Great plugin!

    But I found a bugg using this plugin with WP 3.9.1, when and image is inserted in the description and save, the description will not load in the backend.

    I displays correct in front end, but if you try to edit, it will not load the content in the RTE edit

  • Sander

    When pasting a text with   in it, the text will not be loaded in the editor anymore when editing category descriptions for example

  • Hadassa Golovenshitz

    Thank you so much for this great plugin! I’m having an issue where the add media button on top of the description area goes through the normal procedure, but when I click add image, nothing happens.
    Can you help me out here?
    Thank you!

  • Marco Moreira

    Does anyone know how to show the (m)qtranslate language tabs on the description editor activated by this plugin?