A shortcode is a simple text code enclosed in square brackets [ ] that lets you add dynamic features or content anywhere on your WordPress website — without writing any PHP or HTML code.

Directorist uses shortcodes to display directory-related content such as listings, search forms, author pages, and more. Each shortcode loads a specific layout or function within a post, page, or widget area.

For example:

[directorist_all_listing]

This shortcode displays all published listings on your site.

How to Use Shortcodes

1. Open the Page or Post Editor
   • From your WordPress dashboard, go to Pages → Add New (or edit an existing page).

1. Add a Shortcode Block
   • Click the + icon to add a new block.
   • Search for “Shortcode” and select it from the block options.

1. Insert the Shortcode
   • Paste the desired shortcode into the block. Example:[directorist_add_listing]
2. Preview and Publish
   • Click Preview to confirm that the shortcode output looks correct.
   • Once satisfied, click Publish to make it live.

You can also add shortcodes in widgets, templates, or theme files using the do_shortcode() function in PHP if you prefer manual integration.

Directorist provides a wide range of shortcodes to help you display directory components anywhere on your website. Each shortcode serves a specific purpose, from showing all listings to enabling front-end submissions, user dashboards, and more.

Shortcodes also support multiple parameters that let you customize how listings and pages are displayed. You can control layout type, number of listings per page, sorting order, and more — all directly through shortcode attributes.

All of these parameters are optional. If you don’t include them, Directorist will automatically use the default options configured in the settings panel at
Directory Listings → Settings → Listing Settings → General Settings.

For example:

[directorist_all_listing view="grid" listings_per_page="9" orderby="date" order="desc"]

This shortcode displays listings in a grid view, showing nine listings per page, ordered by date in descending order.

Learn More

Each shortcode has its own detailed documentation explaining its available parameters, usage examples, and customization options.
Visit the specific shortcode documentation page (e.g., Add Listing Shortcode, All Listings Shortcode, Search Shortcode, etc.) for complete details and practical examples.

Tips for Using Directorist Shortcodes

• Use these shortcodes individually or combine them to create custom directory pages.
• Shortcodes automatically inherit your directory layout and theme styling.
• You can add shortcode parameters (like category, location, or view type) to customize output.
• Always make sure the shortcode is placed inside a Shortcode Block in the editor for best results.

However, if you want to display the front end form on any page or post for adding/submitting listings for your users: Use this shortcode: [directorist_add_listing] Please note that this [directorist_add_listing] shortcode does not accept any parameters/attributes.

[directorist_all_listing]

The [directorist_all_listing] shortcode has many parameters to customize the display of all listings. Let’s have a look at the available parameters and their available values with some description. All of these parameters are OPTIONAL. If you do not use any parameters in the shortcode then the Directorist will use options from the settings page ( Directory Listings → Directory Settings → Listing Settings → General Settings page ).

Parameters:

1. Directory Type: If you are using multi directory feature, then you can display all listings based on specific directory types.
   
   Example: [directorist_all_listing directory_type=”place”]
   
   Replace the directory_type with the slug name of the directory
   
2. View: You can display all listings in a list layout or grid layout. Available Options: list,grid & map view. The default value is the grid.
   
   Example: [directorist_all_listing view=”grid”]
   
3. order by: You can order all listings using this parameter. Options available : title, date,rand & price. The default is the date.
   
   Example: [directorist_all_listing orderby=”date”]
   
4. order: You can sort all listings in ascending or descending order. Options available: asc | desc. The default is desc.
   
   Example: [directorist_all_listing order=”asc”]
   
5. listings_per_page: You can set the number of listing to show per page using this parameter. The default is 6.
   
   Example: [directorist_all_listing listings_per_page=”6″]
   
6. category: Display all listings of one or more categories. Use category slugs separated by a comma.
   
   Example: [directorist_all_listing category=”food,travel,medical”]
   
7. Tag: Display all listings of one or more tags. Use tag slugs separated by a comma.
   
   Example: [directorist_all_listing tag=”car,book,medicine”]
   
8. location: Display all listings of one or more locations by location slug. Use location slugs separated by a comma.
   
   Example: [directorist_all_listing location=”new-york, Michigan”]
   
9. IDs: You can display listings by listing IDs.
   
   Example: [directorist_all_listing ids=”1,2,5″]
   
10. featured_only: Display only featured listing. Options available: yes | no.
    
    Example: [directorist_all_listing featured_only=”yes”]
    
11. logged_in_user_only: You can make all listings page only visible for logged-in users using this parameter. Options available: yes | no.
    
    Example: [directorist_all_listing logged_in_user_only=”no”]
    
12. redirect_page_url: Forward/redirect all listings page using this parameter.
    
    Example: [directorist_all_listing redirect_page_url=”www.aazztech.com”]
    
13. popular_only: Display only popular listing. Options available: yes | no.
    
     Example: [directorist_all_listing popular_only=”yes”]
    
14. header: You can show/hide the header area using these attributes. Options available: yes | no.
    
    Example: [directorist_all_listing header=”yes”]
    
15. header_title: You can customize the header title using this parameter.
    
    Example: [directorist_all_listing header_title=”All Items”]
    
16. columns: You can set the number of columns of the grid view layout using this attribute.
    
    Example: [directorist_all_listing columns=”3″]
    
17. display_preview_image: You can show/hide listing preview images using this parameter. Available Options: yes|no. 
    
    Example: [directorist_all_listing display_preview_image=”yes”]
    
18. advanced_filter: You can show/hide advanced filter using this parameter. Available Options: yes|no.   
    
    Example: [directorist_all_listing advanced_filter=”yes”]
    
19. show_pagination: You can show/hide pagination. Available Options: yes|no. 
    
    Example: [directorist_all_listing show_pagination=”yes”]
    
20. map_height: You can customize the height of the map view layout using this attribute.
    
    Example:  [directorist_all_listing map_height=”350″]

Sample Screenshot

The shortcode output on your site may be a little different because new features are being added and modified with every update.

That’s all about Add Listing Page shortcodes.

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 shortcode [directorist_category] 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.

Attributes/Parameters:

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 the grid.
   
   Example: [directorist_category view=”grid”]
   
2. order by: You can order all listings of a category using this parameter. Options available: title, date & price. The default is the 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 a single category only visible for the logged-in users using this parameter. Options available: yes | no. Example:
   
    [directorist_category logged_in_user_only=”no”]
   
5. redirect_page_url: Forward/redirect a 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 the header area using these attributes. Options available: yes | no.
   
   Example: [directorist_category header=”yes”]
   
8. header_title: You can customize the header title using this parameter.
   
   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 the 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}

It is because the Directorist plugin will use the page with this shortcode to display all listings of a specific location dynamically when a user clicks on a single location 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 Location: [directorist_location] The [directorist_location] shortcode has a number of parameters to customize the output. Let’s have a look at the available parameters and their available values with some description.

Attributes/Parameters:

1. view: You can display all listings of a location in a list, grid, and map layout. Available Options: list, grid, and map view. The default value is the grid.
   
   Example: [directorist_location view=”grid”]
   
2. order by: You can order all listings of a location using this parameter. The available options are title, date & price. The default is the date.
   
   Example: [directorist_location orderby=”date”]
   
3. order: You can sort all listings of a location in ascending or descending order. Options available: asc | desc. The default is asc.
   
   Example: [directorist_location order=”asc”]
4. logged_in_user_only: You can make a single location page only visible for the logged-in users using this parameter. Options available: yes | no.
   
   Example: [directorist_location logged_in_user_only=”no”]
   
5. redirect_page_url: Forward/redirect single location page using this parameter.
   
   Example: [directorist_location 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_location listings_per_page=”6″]
   
7. header: You can show/hide the header area using these attributes. Options available: yes | no.
   
   Example: [directorist_location header=”yes”]
8. header_title: You can customize the header title using this parameter.
   
   Example [directorist_location header_title=”Total Listing Found: “]
   
9. columns: You can set the number of columns of the grid view layout using this attribute.
   
   Example [directorist_location columns=”3″]
   
10. show_pagination: You can show/hide pagination. Available Options: yes|no.
    
    Example [directorist_location show_pagination=”yes”]
    
11. map_height: You can customize the height of the map view layout using this attribute.
    
    Example [directorist_location map_height=”350″]

Bonus tips: Suppose your single location page URL is like this (https://yourwebsite.com/single-location-page-url) and you have two locations New York and London. Then you can display/view all listings in New York by visiting https://yourwebsite.com/single-location-page-url/new-york and view all listings/cars in London by visiting https://yourwebsite.com/single-location-page-url/london. Now you may have noticed how this single location page works dynamically. So basically it works like this. https://yourwebsite.com/single-location-page-url/{location_name}

Single Tag Shortcode: [directorist_tag] The shortcode [directorist_tag] 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.

Attributes/Parameters:

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

Bonus tips: Suppose your single tag page URL is like this (https://yourwebsite.com/single-tag-page-url) and you have two tags BMW and Nissan. Then you can display/view all listings under the BMW tag by visiting https://yourwebsite.com/single-tag-page-url/bmw and view all listings/cars by Nissan by visiting https://yourwebsite.com/single-tag-page-url/nissan. Now you may have noticed how this single tag page works dynamically. So basically it works like this. https://yourwebsite.com/single-tag-page-url/{tag_name} NB: You may be wondering if there is a shortcode to display all directorist tags. The reality is there is no shortcode for displaying all tags. It is because people usually do not need it. However, you can display all tags using the directorist tags widget which can be found in the WordPress Dashboard → Appearance → Widgets page.

Directorist all locations shortcode : [directorist_all_locations].
The [directorist_all_locations] shortcode has many parameters to customize the display of all locations. Let’s have a look at the available parameters and their available values with some description.

Attributes/Parameters:

• view: You can display all locations in a list layout or grid layout. Available Options: list | grid view. The default value is the grid.
  
  Example: [directorist_all_locations view=”grid”]
  
• order by: You can order all locations using this attribute. Available Options : id | count | name | slug. The default is id.
  
  Example: [directorist_all_locations orderby =”id”]
  
• order: You can sort all locations in ascending or descending order using this attribute. Available Options: asc | desc. The default is asc.
  
  Example: [directorist_all_locations order=”asc”]
  
• logged_in_user_only: You can make all locations page only visible for logged-in users using this parameter. Options available: yes | no.
  
  Example: [directorist_all_locations logged_in_user_only=”no”]
  
• redirect_page_url: Forward/redirect all locations page using this parameter.
  
  Example: [directorist_all_locations redirect_page_url=”www.aazztech.com”]
  
• columns: You can set the number of columns of the grid view layout using this attribute.
  
  Example [directorist_all_locations columns=”3″]
  
• loc_per_page: You can set the number of locations to show per page using this parameter. The default is 100.
  
  Example: [directorist_all_locations loc_per_page=”6″]
  
• slug: You can display any locations by using this attribute.
  
  Example: [directorist_all_locations slug=”usa”]

Sample Screenshot

The shortcode output on your site may be a little different because new features are being added and modified with every update.

Video

That’s all about All Locations Page shortcodes.

• logged_in_user_only: You can make search listings page only visible for the logged-in users using this parameter. Options available: yes | no.
  
  Example: [directorist_search_listing logged_in_user_only=”no”]
  
• redirect_page_url: Forward/redirect search listings page using this parameter.
  
  Example: [directorist_search_listing redirect_page_url=”www.aazztech.com”]
  
• search_bar_title: You can modify the search bar title by these attributes. The default value is Search here.
  
  Example usage: [directorist_search_listing search_bar_title=”Search here”]
  
• show_title_subtitle: You can show/hide search subtitles using this attribute. Available Options: yes | no. The default value is “yes”.
  
  Example usage: [directorist_search_listing show_title_subtitle=”yes”]
  
• search_bar_sub_title: You can modify the search bar subtitle by these attributes. The default value is “Find the best match of your interest”.
  
  Example usage: [directorist_search_listing search_bar_sub_title=”Find the best match of your interest”]
  
• text_field: You can show/hide the text field by this attribute. Available Options: yes | no. The default value is “yes”.
  
  Example usage: [directorist_search_listing filter_text=”yes”]
  
• category_field: You can show/hide the category field by this attribute. Options available: yes |no. The default value is “yes”.
  
  Example usage: [directorist_search_listing filter_category=”yes”]
  
• location_field: You can show/hide the location field by this attribute. Options available: yes | no. The default value is “yes”.
  
  Example usage: [directorist_search_listing filter_location=”yes”]
  
• search_button_text: You can change the search button text by these attributes. The default value is “Search Listing”.
  
  Example usage: [directorist_search_listing search_button_text=”Search Listing”]
  
• more_filters_button: You can hide/show the “more filters” button by this attribute. Options available: yes | no. The default value is yes.
  
  Example usage: [directorist_search_listing more_filters_button=”yes”]
  
• more_filters_text: You can change more filters text by this attribute. The default value is More Filters.
  
  Example usage: [directorist_search_listing more_filters_text=”More Filters”]
  
• price_min_max_field: You can show/hide price minimum and maximum fields by this attribute. Available Options: yes | no. The default value is “yes”.
  
  Example usage: [directorist_search_listing price_min_max_field=”yes”]
  
• price_range_field: You can show/hide the price range field by this attribute. Available Options: yes | no. The default value is “no”.
  
  Example usage: [directorist_search_listing price_range_field=”no”]
  
• rating_field: You can show/hide the rating_field field by this attribute. Available Options: yes | no. The default value is “yes”.
  
  Example usage: [directorist_search_listing rating_field=”yes”]
  
• tag_field: You can show/hide the tag field by this attribute. Available Options: yes | no. The default value is “yes”.
  
  Example usage: [directorist_search_listing tag_field=”yes”]
  
• open_now_field: You can show/hide open now field by this attribute. Available Options: yes | no. The default value is “no”.
  
  Example usage: [directorist_search_listing open_now_field=”no”]
  
• custom_fields: You can show/hide open custom fields by this attribute. Available Options: yes | no. The default value is “yes”.
  
  Example usage: [directorist_search_listing custom_fields=”yes”]
  
• website_field: You can show/hide the website field by this attribute. Available Options: yes | no. The default value is “no”.
  
  Example usage: [directorist_search_listing website_field=”no”]
  
• email_field: You can show/hide the email field by this attribute. Available Options: yes | no. The default value is “no”.
  
  Example usage: [directorist_search_listing email_field=”no”]
  
• phone_field: You can show/hide the phone field by this attribute. Available Options: yes | no. The default value is “no”.
  
  Example usage: [directorist_search_listing phone_field=”no”]
  
• fax: You can show/hide the fax field by this attribute. Available Options: yes | no. The default value is “no”.
  
  Example usage: [directorist_search_listing fax=”no”]
  
• address_field: You can show/hide the address field by this attribute. Available Options: yes | no. The default value is “no”.
  
  Example usage: [directorist_search_listing address_field=”no”]
  
• zip_code_field: You can show/hide the zip/postcode field by this attribute. Available Options: yes | no. The default value is “no”.
  
  Example usage: [directorist_search_listing zip_code_field=”no”]
  
• reset_filters_button: You can show/hide the reset filters button by this attribute. Available Options: yes | no. The default value is “yes”.
  
  Example usage: [directorist_search_listing reset_filters_button=”yes”]
  
• apply_filters_button: You can show/hide the apply filters button by this attribute. Available Options: yes | no. The default value is “yes”.
  
  Example usage: [directorist_search_listing apply_filters_button=”yes”]
  
• reset_filters_text: You can modify reset filters text by these attributes. The default value is Reset Filters.
  
  Example usage: [directorist_search_listing reset_filters_text=”Reset Filters”]
  
• apply_filters_text: You can modify apply filters text by these attributes. The default value is “Apply Filters”.
  
  Example usage: [directorist_search_listing apply_filters_text=”Apply Filters”]
  
• more_filters_display: You can display more filters by overlapping, sliding, and always_open. The default value is “overlapping “.
  
  Example usage: [directorist_search_listing more_filters_display=”overlapping”]

Sample Screenshot

The shortcode output on your site may be a little different because new features are being added and modified with every update.

That’s all about Search Listings page shortcodes.

You can display a message to a user when a transaction fails using this shortcode. DIrectorist will redirect the user automatically to the page where this shortcode is used. However, you need to assign this page to the Transaction Failure Page option in the Directory Settings → Pages, Links, and Views. 

Transaction Failure Shortcode: [directorist_transaction_failure] This shortcode does not have any attributes/parameters

Payment Receipt

You can show the complete details of the purchase to the customer after completing a purchase using this shortcode. However, If you visit the page directly, you will not see any content. Rather you may see an error message somewhat like this “Sorry! No order id has been provided.“. It is because the directorist uses this page automatically when necessary. You need to add the shortcode in a page and assign the page to the payment/order receipt page option in the Directory Settings → Pages, Links, and Views.

Payment Receipt Shortcode: [directorist_payment_receipt] This shortcode does not have any attributes/parameters.

Sample Screenshot

The shortcode output on your site may be a little different because new features are being added and modified with every update.

Checkout/Cart

Use this shortcode [directorist_checkout] to display the Directorist cart and checkout information on any page or post you like. This shortcode does not have any attributes/parameters. If you visit the page directly, you will not see any content. Rather you may see an error message somewhat like this “Sorry, Something went wrong. The listing ID is missing. Please try again. “. It is because Directorist uses this page automatically when necessary. You need to add the shortcode in a page and assign the page to the Checkout/Cart option in the Directory Settings → Pages, Links, and Views. Checkout/Cart Shortcode:[directorist_checkout] The [directorist_checkout]  shortcode will also output all payment gateways information so that the user can pay/checkout using any gateway they like.

Sample Screenshot

The shortcode output on your site may be a little different because new features are being added and modified with every update.

That’s all about Payment & Checkout Page shortcodes.