# Courses Listing

The **Courses Listing Shortcode** allows you to display a list of available courses on any page or post. You can customize the output using various parameters such as category, instructor, number of courses, layout style, and sorting options.

<figure><img src="https://content.gitbook.com/content/FWDykheMbBOzsPpHi9FR/blobs/ZYbdZJqYtdvKZYh5CfUE/course_listing.jpg" alt=""><figcaption></figcaption></figure>

#### **Courses Listing Shortcode**&#x20;

Use the following parameters to customize the `[dtlms_course_listing]` shortcode:

<table data-header-hidden><thead><tr><th width="238.4444580078125"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Description</strong></td></tr><tr><td><code>disable-all-filters</code></td><td><code>true</code> or <code>false</code> – Disable all 7 available filters for the course listing.</td></tr><tr><td><code>enable-search-filter</code></td><td><code>true</code> or <code>false</code> – Enable the <strong>Search Course</strong> text field.</td></tr><tr><td><code>enable-display-filter</code></td><td><code>true</code> or <code>false</code> – Enable <strong>Grid/List</strong> view switcher.</td></tr><tr><td><code>enable-category-filter</code></td><td><code>true</code> or <code>false</code> – Enable <strong>Category</strong> filter.</td></tr><tr><td><code>enable-orderby-filter</code></td><td><code>true</code> or <code>false</code> – Enable <strong>Order By</strong> filter.</td></tr><tr><td><code>enable-instructor-filter</code></td><td><code>true</code> or <code>false</code> – Enable <strong>Instructor</strong> filter.</td></tr><tr><td><code>enable-cost-filter</code></td><td><code>true</code> or <code>false</code> – Enable <strong>Cost</strong> filter (Free/Paid).</td></tr><tr><td><code>enable-date-filter</code></td><td><code>true</code> or <code>false</code> – Enable <strong>Start Date</strong> filter.</td></tr><tr><td><code>listing-output-page</code></td><td>Choose a page where search results should appear. If <strong>Default - Ajax Output</strong> is selected, results appear on the same page.</td></tr><tr><td><code>default-filter</code></td><td><code>upcoming-courses</code>, <code>recent-courses</code>, <code>highest-rated-courses</code>, <code>most-membered-courses</code>, <code>paid-courses</code>, or <code>free-courses</code>. Requires filters to be off.</td></tr><tr><td><code>default-display-type</code></td><td><code>list</code> or <code>grid</code> – Default display format (only applicable if <strong>Default - Ajax Output</strong> is chosen).</td></tr><tr><td><code>course-item-ids</code></td><td>Enter specific course IDs (comma-separated) to include (only for non-Ajax output pages).</td></tr><tr><td><code>course-category-ids</code></td><td>Enter specific category IDs (comma-separated) to include (only for non-Ajax output pages).</td></tr><tr><td><code>instructor-ids</code></td><td>Enter instructor IDs (comma-separated) to filter results (only for non-Ajax output pages).</td></tr><tr><td><code>apply-isotope</code></td><td><code>true</code> or <code>false</code> – Enable Isotope layout (not compatible with carousel).</td></tr><tr><td><code>enable-category-isotope-filter</code></td><td><code>true</code> or <code>false</code> – Enable Category Isotope filter.</td></tr><tr><td><code>show-author-details</code></td><td><code>true</code> or <code>false</code> – Show author (instructor) details with each course.</td></tr><tr><td><code>post-per-page</code></td><td>Set how many courses to display per page.</td></tr><tr><td><code>columns</code></td><td><code>1</code>, <code>2</code>, or <code>3</code> – Number of columns in Grid View. “3 Columns” works only when <code>enable-fullwidth=true</code> and filters are disabled.</td></tr><tr><td><code>enable-fullwidth</code></td><td><code>true</code> or <code>false</code> – Enable full-width layout.</td></tr><tr><td><code>type</code></td><td><code>type1</code>, <code>type2</code>, or <code>type3</code> – Select design layout.</td></tr><tr><td><code>class</code></td><td>Add custom CSS class for additional styling.</td></tr></tbody></table>

***

**Carousel Specific Parameters**

<table data-header-hidden><thead><tr><th width="227.33331298828125"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter</strong></td><td><strong>Description</strong></td></tr><tr><td><code>enable-carousel</code></td><td><code>true</code> or <code>false</code> – Enable Carousel layout. Not compatible with Isotope layout.</td></tr><tr><td><code>carousel-autoplay</code></td><td>Autoplay delay in milliseconds (e.g., <code>1000</code>). Leave empty to disable autoplay.</td></tr><tr><td><code>carousel-slidesperview</code></td><td><code>1</code>, <code>2</code>, or <code>3</code> – Number of slides visible at a time. If using <strong>List View</strong>, only <code>1</code> is valid.</td></tr><tr><td><code>carousel-loopmode</code></td><td><code>true</code> or <code>false</code> – Enable continuous loop mode.</td></tr><tr><td><code>carousel-mousewheelcontrol</code></td><td><code>true</code> or <code>false</code> – Enable navigation via mouse wheel.</td></tr><tr><td><code>carousel-bulletpagination</code></td><td><code>true</code> or <code>false</code> – Enable bullet-style pagination.</td></tr><tr><td><code>carousel-arrowpagination</code></td><td><code>true</code> or <code>false</code> – Enable arrow-based navigation.</td></tr><tr><td><code>carousel-spacebetween</code></td><td>Space (in px) between slides. Example: <code>15px</code>.</td></tr></tbody></table>

```
[dtlms_courses_listing disable-all-filters="false" enable-search-filter="true" enable-display-filter="true" enable-orderby-filter="true" enable-category-filter="true" enable-instructor-filter="true" enable-cost-filter="true" enable-date-filter="true" apply-isotope="false" enable-category-isotope-filter="true" show-author-details="true" columns="3" enable-carousel="true" carousel-slidesperview="2" carousel-loopmode="true" carousel-mousewheelcontrol="true" carousel-bulletpagination="true" carousel-arrowpagination="true" post-per-page="6" carousel-autoplay="1000" carousel-spacebetween="10px" class="custom-class"]
```

<figure><img src="https://content.gitbook.com/content/FWDykheMbBOzsPpHi9FR/blobs/bqnfxtlupJPWuGjcCjEI/course_listing_shortcode.png" alt=""><figcaption></figcaption></figure>