1. Home
  2. Docs
  3. Shortcodes
  4. Shortcodes
  5. Single category

Single category

You can display all listings of a single category using the following shortcode. Remember, if you visit the page after adding this [directorist_category] shortcode directly, you will see something like this ‘No Results Found.’ message. It is because the Directorist plugin will use the page with this shortcode to display all listings of a specific category dynamically when a user clicks on a single category anywhere on your website. In other words, this page is not for direct access so it is better not to include the page with this shortcode in the nav menu.

Single Category Shortcode: [directorist_category]

The [directorist_category] shortcode has a number of parameters to customize the output. Let’s have a look at the available attributes/parameters and their available values with some description.


  1. view: You can display all listings of a category in a list, grid or map layout. Available Options: list, grid and map view. The default value is grid. Example: [directorist_category view=”grid”]
  2. orderby : You can order all listings of a category using this parameter. Options available : title, date & price. The default is date. Example: [directorist_category orderby=”date”].
  3. order: You can sort all listings of a category in ascending or descending order. Options available: asc | desc. The default is asc. Example: [directorist_category order=”asc”].
  4. logged_in_user_only: You can make single category only visible for logged in user using this parameter. Options available: yes | no. Example: [directorist_category logged_in_user_only=”no”].
  5. redirect_page_url: Forward/redirect single category page using this parameter. Example: [directorist_category redirect_page_url=”www.aazztech.com”].
  6. listings_per_page: You can set the number of listing to show per page using this parameter. The default is 6. Example: [directorist_category listings_per_page=”6″].
  7. header: You can show/hide header area using this attributes. Options available: yes | no. Example: [directorist_category header=”yes”]
  8. header_title: You can customize header title using this parameter. For example [directorist_category header_title=”Total Listing Found: “]
  9. columns: You can set the number of columns of the grid view layout using this attribute. Example [directorist_category columns=”3″]
  10. show_pagination: You can show/hide pagination. Available options: yes|no. Example [directorist_category show_pagination=”yes”]
  11. map_height: You can customize the height of the map view layout using this attribute. Example [directorist_category map_height=”350″]



Bonus tips: Suppose your single category page url is like this (https://yourwebsite.com/single-category-page-url) and you have two categories BMW and Nissan. Then you can display/view all listings under bmw category by visiting https://yourwebsite.com/single-category-page-url/bmw and view all listings/cars by Nissan by visiting https://yourwebsite.com/single-category-page-url/nissan. Now you may have noticed how this single category page works dynamically. So basically it works like this. https://yourwebsite.com/single-category-page-url/{category_name}