3rd Party (Free)

269 downloads (last 90 days)

BSD 3-Clause License Download v1.2.0

EE Version Support

  • ExpressionEngine 2


If an item is crossed out, it might be untested, not applicable or incompatible. Contact the developer to be sure.

  • Updater
  • Multi Site Manager
  • Stand Alone Entry Form
  • Low Variables
  • Content Elements
  • Better Workflow
  • Matrix
  • Grid
  • Webservice
  • Publisher


  • jQuery for the Control Panel

Add-On Type(s)



Retrieve category data in a sane manner.


ExpressionEngine is good, but sometimes that channel categories tag can be a bit limiting. There’s not a lot of controlling the markup when outputting nested categories from the native tag. And you can’t get children without parents.

This plugin offers you a way to get categories on your terms, with your markup, in a way that suites you best.

Single Tag

{exp:categoree:single show="1"}


Get the category_name, category_url_title, category_description, or category_parent_id of a single category by ID.



Required. This is the category ID of the category you wish to get data from.


Optional: default is category_name. This allows you to choose which category field data to retrieve.

Possible values: category_name, category_url_title, category_description, or category_parent_id.

Tag Pair

{exp:categoree:pair show="1|2|3" backspace="2"}{category_name}, {/exp:categoree:pair}


Loop through categories and display category_id, category_name, category_url_title, category_description, or category_parent_id.

Note when using the show parameter without nesting, this will get the specified category ID REGARDLESS of the category hierarchy!



Optional: default is all categories.

Value: Category ID or IDs of the category or categories you wish to get data from.


Optional: default is false.

Value: Entry ID of the the entry you would like to get categories for.


Use in conjunction with the “show” parameter. This will display catetories in exactly the order you have specified the category IDs in the show parameter. Default sorting is by group and category order.


Optional: default is all groups.

Value: Pipe separated list of group IDs to get categories from.


Optional: default is false

Display only parent categories. Cannot be used with the nesting parameter since nesting would not apply.


Optional: default is false.

Display only the children of a specified parent ID. Cannot be used with the parent_only parameter, or the nest parameter.


Optional: Integer. Default is false.

Makes additional tags available for category nesting and set the level of nesting (see below).


Namespace all tags to prevent conflicts with parent tags. So {category_name} becomes {my_namespace:category_name}


As with any tag pair, this allows you to remove your separator(s) (such as a comma) from the last result.

Variables available inside the tag pair (not nested)


Additional variables when using nesting

{level} (integer)
{level_count} (integer)
{level_start} (boolean)
{level_end} (boolean)
{level_total_results} (integer)


Some of these examples may be a bit simple, but should demonstrate how powerful the tags are and how easy it is to control the markup.

Get the name of a category by ID with the single tag

{exp:categoree:single show="82"}

<h4>Loop through the names of a category group</h4>

{exp:categoree:pair group="21" parent_only="yes" backspace="2"}{category_name}, {/exp:categoree:pair}

Simple nesting with namespacing

    {exp:categoree:pair group="21" nest="10" namespace="categoree"}
        {if categoree:level != 1 AND categoree:level_start}
        <ul class="level-{categoree:level}">
        {if categoree:level != 1 AND categoree:level_end}

2 Level Nesting with top level as a heading

{exp:categoree:pair group="21" nest="2"}
    {if level == 1}
    {if level == 2}
        {if level_count == 1}<ul>{/if}
            <li><a href="/downloads/{category_url_title}">{category_name}</a>&tl;/li>
        {if level_count == level_total_results}</ul>{/if}

Download Categoree

EE Support Downloads Add-On Version Release Date
Not Specified Download 1.2.0 Oct 9, 2014

Categoree Links

This entry was created July 17, 2014, 9:35 am.
This entry was last updated October 9, 2014, 12:08 pm.

Disclaimer: Information about ExpressionEngine add-ons is provided as a service to you, the user, and every member of the ExpressionEngine community. devot:ee is not responsible if you hose, mangle, wreck, or otherwise destroy your EE website by installing an add-on that you found out about at this site, regardless of its rating, Favorites status, commercial or free status, or general popularity. Caveat EEmptor!

Returns: devot:ee has a 30-day return policy on all commercial add-ons sold through If you need to return an add-on, do not go to the developer or the developer's site, but rather visit our returns page at to initiate your return. If you have questions, email

There are no reviews for this add-on yet.

What are you waiting for? Rate it and review it!