To use this skin, navigate to Listdom → Shortcodes → Add Shortcode and select the List skin from the available skin options. Once selected, you can configure various settings for how your listings will appear in the list layout. The List skin is ideal for directory listings or any scenario where you want each listing to appear as a full-width entry.
Under the Style tab, you can choose a style variation for the List skin and customize which elements are shown on each listing card. Begin by selecting a Style (pre-designed layout) for the list. By default, Style 1 is selected, but you may choose Style 2, Style 3, or Style 4 for different appearances.
Display Image: Toggle to show or hide the listing’s featured image (or gallery slider) on each listing card. This option is part of the Listdom Pro features Pro. When enabled, additional image settings appear:
Image Method: Choose how images are displayed. Cover shows only the featured image as a static cover image, while Slider displays all gallery images in a slider/carousel on the listing card.
Image Fit: Select how the image fills its container. Cover (default) will crop/zoom to fill the area, and Contain will letterbox the image to show the whole image without cropping.
Note: If Display Image is turned off, no listing images will appear in the list view.
Display Description: Toggle to include a short description or excerpt for each listing. If enabled, you can set:
Content Length: The number of words to show from the description/excerpt. For example, setting 12 (default) will display up to 12 words of the listing’s content.
Content Type: Choose whether to use the listing’s Description (full content) or Excerpt for the summary text. By default, the skin uses the excerpt.
Styles: The description content is available in style layouts that support showing text excerpts (e.g., Style 2 and Style 3 for the List skin). In styles where no description area exists, this toggle may be hidden and descriptions will not be shown.
These toggles let you show or hide additional listing details. Availability of each element may depend on the selected style or enabled add-ons:
Contact Info: Show contact information (such as the contact button or quick contact details) on the listing card. (Visible in Style 1 and Style 4 layouts.)
Location: Display the location name of the listing. (Visible in Style 2 layouts.)
Price Class: Show the price category or price class (e.g., ”$$$” or budget classification) if your site uses price classes. (Requires that pricing components are enabled and is shown in Style 3.)
Price: Display the listing’s price or price field on the card (for example, an amount or price label). This option appears if pricing is enabled in Listdom. (Shown in Style 1, Style 2, and Style 4.)
Display Matched Bookables: If the Listdom Booking add-on is active, show matched bookable items directly on the listing card so visitors can quickly see what can be booked. This appears in styles that provide space for the booking snippet.
Share Buttons: Include social Share buttons (e.g., Facebook, Twitter icons) on each listing for easy sharing. (Requires that social sharing components are enabled; available in Style 1, Style 2, and Style 4.)
Address: Show the listing’s address on the card. (Requires the Map component; visible in Style 1 and Style 3 layouts where an address is part of the design.)
Work Hours: Display the listing’s availability or work hours (open/closed status or hours of operation). (Requires the working hours feature to be enabled; visible in Style 2 and Style 3.)
Categories: Show the category (or categories) assigned to the listing. (Visible in Style 2, Style 3, and Style 4.)
Labels: Show any Labels associated with the listing (for example, custom labels or statuses like “Featured” or “Open Now”). This is enabled by default and applies to all styles.
Favorite Icon: Show a “favorite” (heart) icon on each listing, allowing users to add the listing to their favorites. (This requires the Listdom Favorite add-on to be installed and activated. Favorite)
Compare Icon: Show a “compare” (scale) icon on each listing, allowing users to add the listing to a comparison list. (Requires the Listdom Compare add-on. Compare)
Review Stars: Display the listing’s average rating as star icons (if your site has reviews for listings). (Requires the Listdom Reviews add-on for review functionality. Reviews)
Title: Toggle the listing title on or off. By default, the Title is always displayed (enabled). It’s generally recommended to leave this on so users can see each listing’s name.
Claim Status: If the Claim/Claimable Listings add-on is used, this toggle will show a “claimed” badge or status on listings that have been claimed by their owners. (Requires the Listdom Claim add-on. Claim) This option only appears when Title is enabled, and only for styles that support the claim badge (e.g., Style 3 and Style 4).
If you want to include a map with your list of listings, the Map tab provides various settings for map display and behavior. (These options require that the Map component is enabled – Listdom supports maps via Leaflet or Google Maps.)
Map Provider: Choose the map platform (Leaflet or Google Maps) for displaying the map. By default, this inherits from global settings. (This field may be locked if configured globally; Leaflet is the default provider in Listdom.)
Position: Decide where the map is displayed relative to the list. Options:
Show before the List view (Top) – Map appears above the list.
Show after the List view (Bottom) – Map appears below the list.
Show on left – Map is shown to the left side of the listings (the list will appear on the right side).
Show on right – Map is shown to the right side of the listings.
Map Style: (Google Maps only) If using Google Maps, select a map style (the visual theme of the map). This can be left blank to use the default style or choose a custom style if available.
Map Height: Set a custom height for the map display. You can specify a value in pixels (e.g., 500px) or in viewport height (e.g., 100vh). If left blank, a default height will be used. Adjust this if you need a taller or shorter map on the page.
Mouse Wheel Zoom: Enable or disable zooming the map via mouse wheel/trackpad scroll. Disabled is the default to prevent accidental zooming while scrolling the page. Toggle to Enabled when you want scroll-to-zoom behavior.
Marker/Shape On Click: Define what happens when a user clicks a map marker (or shape) that represents a listing:
Open Infowindow – Open a small info popup on the map with listing details (default behavior).
Redirect to Single Listing Page – Immediately navigate to the listing’s own page.
Open Single Listing in a Lightbox – Open the full listing details in a lightbox overlay (without leaving the page).
None – Do nothing on marker click.
This setting allows you to control the user experience when interacting with map points.
Info Window Trigger: Appears when Marker/Shape On Click is set to Open Infowindow. Choose Show on click (default) or Show on hover to control how the infowindow opens. This applies to markers only (not shapes).
If multiple listings are close to each other on the map, you can use clustering to combine them into a single marker that shows a count.
Enable Clustering: Toggle to enable cluster grouping of nearby markers. When enabled, listings in proximity will be shown as a cluster (usually a circle with a number).
Bubbles: Choose the style of cluster “bubbles” (the marker icons that represent clusters). Listdom provides several cluster icon styles (sizes and colors) – select one from the dropdown. This option is available when clustering is enabled. (If using Google Maps as the provider, cluster images will appear as selected. Leaflet uses its default clustering style.)
Map Search: Enable this to allow the map view to filter listings based on the map’s current viewport. When Map Search is on, as users move or zoom the map, the list of listings will update to show only listings visible in the current map area. (This is a Pro feature and requires Listdom Pro. If you are using the free version, this option will be shown as unavailable.)
When Map Search is enabled, users can find listings in the visible map bounds, which is useful for geo-directory scenarios.
Map Limit: Specify the maximum number of listing markers to load on the map. The default is 300. Be cautious when increasing this number: a very high limit can slow down page loading and map performance. It’s recommended to use filter options to narrow down listings rather than loading too many at once. If you only want to display a specific set of listings, you can lower this number for performance.
(Advanced users: Listdom’s Map settings also support KML layers and other custom behaviors via extensions, which can be added by third-party plugins hooking into Listdom.)
In the Layout tab, configure how the listing results are paginated and displayed on the page.
Listings Per Row: (Not applicable for List skin) Since the List skin displays one listing per row by design, this setting is fixed to 1. (For grid-based skins, you can choose multiple columns, but List skin is always single-column.)
Limit: Set how many listings to show per page. The default is 12. If you have more listings than this limit, the additional listings will be accessible via pagination or “Load More” (depending on the Pagination Method setting).
Pagination Method: Choose how users can navigate through multiple pages of listings:
Load More – Users click a Load More button to append the next set of listings below the current list (infinite scrolling style).
Numeric Pagination – Traditional pages (1, 2, 3, …) for the listings.
Disabled – No pagination controls. If you select this, only the first page of results (up to the Limit) will be shown and users cannot load more.
By default, Listdom uses Load More for the List skin, but you can select your preferred method.
Listing Link: Define how the single listing page opens when a listing is clicked. (This is a Pro feature; in Listdom Lite, this setting is not available.) Options include:
Normal – Clicking a listing opens the single listing in the current window (default behavior).
Lightbox – Open the single listing page in a lightbox overlay on the same page.
Right Panel / Left Panel / Bottom Panel – Open the single listing in a side panel (or bottom drawer) on the page.
If a panel or lightbox method is chosen, an additional option Listing Style in Lightbox will appear, allowing you to select which single listing layout/style to use in the popup. If no specific style is chosen, it will inherit the global single listing style.
Under Default Sort, choose how listings are initially ordered when they are displayed:
Default Sort Field: Select the default sorting criterion (e.g., Date Posted, Title, Price, Rating, etc.). For example, you might choose Date to sort listings by newest first, or Price to sort by price.
Default Sort Order: Select Ascending or Descending for the default field. For instance, if the field is Date and order is Descending, listings will start with the most recent.
By setting a default sort, you control the initial listing order before the user applies any manual sorting.
You can enable or disable the sorting dropdown/list that appears above the listings and configure which sorting options are available to users:
Display Sort Options: Toggle this on to show the sort controls to visitors (a dropdown or list of sort criteria). If turned off, users will not see any sort menu and cannot change the sort order (the listings will remain in the Default Sort order).
Sort Style: Choose how the sort interface is displayed to users:
Drop Down – A compact dropdown menu (visitors click and select a sort option).
List – A list of sorting choices (usually as buttons or links) visible by default.
Available Sort Options: Configure which sorting criteria users can choose from, and in what order:
Common sort options include Date, Title, Price, Views, Rating, etc. All available options are listed.
You can reorder the options by dragging them in the list – the order here will be the order they appear to users.
Click the toggle icon next to each sort option to enable or disable it. Enabled options (with a checkmark icon) will be offered to users; disabled ones will be hidden.
For each sort criterion, you can also customize the label (Name) that appears to users and set its default order (Ascending or Descending). For example, you might label a sort by a custom field as “Sort by Size” and choose a default order.
If you have the Display Sort Options turned on, make sure to enable at least one sort criterion in the list. If all options are disabled, the sort control will not show any choices to the user.
Use the Search tab to embed a search/filter form directly with your list. This is useful if you want users to narrow down the listings they see in the list:
Searchable: Toggle to enable or disable search for this shortcode. When enabled, the list can be filtered by a search form. When disabled, the shortcode shows fixed results that do not change based on search queries.
Search Form: Select which Listdom search form to display with this list. This dropdown will list any search forms you have created by their titles. Choose a form that has fields relevant to these listings.
Search Form Position: Choose where the search form appears in relation to the list:
Show on top
Show on bottom
Show on left
Show on right
Show before the listings
Top or bottom placement usually works best. Left or right can be used as a sidebar, and “Show before the listings” places the form ahead of the listing content.
Sticky Search Form: When using Show on left or Show on right, enable this option to keep the sidebar form visible while scrolling. If the form is taller than the viewport, Listdom automatically adds a vertical scrollbar.
Sticky Offset (px): Set the top spacing for sticky sidebar forms. This helps prevent overlap with fixed headers. Leave it empty to use default spacing.
Disabled: Submit normally with a full page reload.
On Submit: Apply filters via AJAX when the user submits the form.
On The Fly: Update results as the user changes fields.
The fields users see come from the selected search form itself. The Search settings here only control placement and behavior.
Usually, you will create a custom search form tailored to the listings shown in the list and select it here. That way, users can refine what they see without leaving the page.
To build and configure those forms, see Create Search & Filter Form and Search Form Fields and Options. For a practical walkthrough, see Listdom Search Forms.
The Filter Options tab lets you predefine criteria to limit which listings are shown in this list, even before any user search or interaction. These filters work behind the scenes to include or exclude listings based on taxonomy terms or other attributes.
For each filter type below, you can configure an Include list or Exclude list of terms. “Include” means only show listings that have those terms. “Exclude” means hide any listings that have those terms. If you leave a filter category blank, it imposes no restriction on that aspect.
Categories: Filter by listing categories.
Include Categories: Choose one or more categories; only listings in those categories will appear in this list.
Exclude CategoriesPro: Choose categories to omit; any listing in those categories will be left out.
Locations: Filter by location taxonomy.
Include Locations: Only show listings that are in the selected location(s).
Exclude LocationsPro: Omit listings that are in the selected location(s).
Tags: Filter by listing tags.
Include Tags: Show listings that have at least one of these tags.
Exclude TagsPro: Do not show listings that have any of these tags.
Features: Filter by features (these are like amenities or boolean attributes of a listing).
Include Features: Listings that have any of the selected feature(s) will be included.
Exclude FeaturesPro: Exclude listings that have any of the selected features.
Labels: Filter by label terms.
Include Labels: Show only listings that have one of these label(s) (for example, only “Featured” listings).
Exclude LabelsPro: Hide listings that have any of these labels.
Author (Listing Owner): You can restrict by listing author (the user who posted the listing).
Select one or more authors under Include to show only listings by those user accounts.
Or select authors under Exclude Pro to hide listings by those users.
Custom Fields: If you have custom fields associated with listings, they appear here for filtering based on the field type. Use these to include listings based on custom metadata (exclude options are not available for custom fields).
Checkbox: Enter the checkbox value to match.
Time: Pick a time value.
Date: Select a date.
Tel: Enter a phone value.
Textarea: Enter text to match the textarea content.
Text: Enter text to match the field value.
Number: Set a minimum and/or maximum range (two numeric inputs).
Dropdown: Choose one or more values from the dropdown list (multi-select).
Radio: Enter the radio value to match.
Datetime: Select a date and time value.
URL: Enter a URL value.
Email: Enter an email value.
Image: Image fields are not available as filters in this section.
Rank AddonRank: Added by the Listdom Rank add-on. Filter listings by rank using minimum and maximum values, or leave them blank to skip ranking filters.
MembershipsMembership: Added by the Listdom Membership add-on. Filter listings by membership packages using checkboxes.
You can combine multiple filters. A listing must satisfy all the Include filters and none of the Exclude filters to appear. Within a single filter type, if multiple terms are included, a listing that has any one of those terms will pass (logical OR for included terms within one filter type). Exclusions work similarly: if a listing has any one of the excluded terms, it will be filtered out.
If no Filter Options are set, the shortcode shows all eligible listings by default.
These pre-filters form the base dataset for the shortcode. If you also attach a search form, that search refines this pre-filtered set rather than replacing it.
Using Filter Options, you can create a list shortcode that is targeted to a specific subset of listings. For example, you might include one category and one location, or exclude one tag, label, or author, to keep the output focused on exactly the content you want.
Local Business Directory (List Skin): A city directory site uses the List skin to list local businesses. Each business appears in a full-width row with its name, address, and a “Contact” button. The admin has enabled the map on top, so visitors can see all business locations on a map above the list. This setup makes it easy to browse businesses in a traditional list while also visualizing their locations.
Job Listings in List Format: A job board website displays its job postings using the List skin. The list shows each job title, company name, and a short excerpt of the job description. The site owner has added a search form at the top (Searchable enabled) so users can filter jobs by keyword or category. They chose numeric pagination for navigation. This provides a straightforward, text-focused list of jobs that’s easy to scroll and search.
Listdom on WordPress.orgLearn more about the Listdom plugin, read reviews, and find the download on the official WordPress repository.
