> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mylisting.club/llms.txt
> Use this file to discover all available pages before exploring further.
# Listing Feeds
> Learn how MyListing listing feeds work: add the Elementor widget, choose grid or carousel layouts, filter listings, and connect preview cards on any page.
MyListing Pro includes a [Listing Feed Taxonomy Sync](https://docs.mylisting.club/listing-feed-taxonomy-sync) module to dynamically configure listing feed taxonomies to build SEO-optimized taxonomy pages faster.
MyListing Pro's [Listing Previews](/listing-previews) module adds modern preview card templates with customizable CTA buttons.
## **What Is a Listing Feed?**
A **listing feed** is a curated block of listings you place on any page. Each listing appears as a **preview card**, the same compact tile visitors see on the Explore page and in search results.
Think of it this way:
* The **Explore page** is your full search experience with filters, maps, and tabs.
* A **listing feed** is a smaller, hand-picked slice of listings you control. You choose which listings appear, how many show at once, and whether they display in a grid or a sliding carousel.
Listing feeds are perfect for homepages, landing pages, category pages, and anywhere you want to highlight specific listings without building a full Explore page.
## **Where Do You Manage Listing Feeds?**
Listing feeds are not configured in wp-admin settings. You add and configure them in **Elementor** using the **27 > Listing Feed** widget.
1. Edit the page in Elementor (homepage, category page, landing page, etc.).
2. Search the widget panel for **Listing Feed** under the **27** category.
3. Drag **27 > Listing Feed** onto the page.
4. Configure the widget settings in the left panel.
5. **Update** or **Publish** the page.
Each feed is independent. You can place multiple Listing Feed widgets on one page, each with its own filters, layout, and listing count.
## **Where Visitors See Listing Feeds**
Visitors see listing feeds wherever you place the widget. Common spots include:
* **Homepage**: Featured listings, newest listings, or listings from a specific category
* **Category or region pages**: All listings in "Restaurants" or "Downtown"
* **Landing pages**: A focused set of promoted listings for a marketing campaign
* **Blog posts or static pages**: Related listings alongside other content
The feed shows **published** listings only. Each card links to the full single listing page when clicked.
## **Grid vs Carousel**
The **Template** setting controls how listings are laid out.
| **Template** | **What it does** |
| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Grid** | Listings appear in a responsive grid. You control column count per screen size. Optional pagination lets visitors load more listings without leaving the page. |
| **Carousel** | Listings slide horizontally. Good for homepages and narrow sections where you want movement without taking much vertical space. |
### **Grid Settings**
| **Setting** | **What it does** |
| :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |
| **Listings per page** | How many listings load in one batch. Default is **6**. |
| **Enable pagination?** | When on, visitors can move through additional listings. When off, only the first batch appears. |
| **Pagination** | **Pages** (numbered links), **Load More** (appends listings below), or **Prev/Next** (simple back and forward). Default is **Prev/Next**. |
| **Disable isotope masonry?** | Isotope adjusts card heights in the grid. Turning this on improves load speed. Use it when cards are a uniform height. |
| **Column count** | Responsive columns: desktop, tablet, and mobile. Default is 3 on desktop, 2 on tablet, 1 on mobile. |
### **Carousel Settings**
| **Setting** | **What it does** |
| :----------------------------- | :----------------------------------------------------------------------------------------------------------------------------- |
| **Customize carousel?** | Reveals advanced carousel controls below. |
| **Switch navigation to dots?** | Shows dot indicators instead of arrow buttons. |
| **Invert nav color?** | Light-colored arrows and dots for dark section backgrounds. |
| **Autoplay?** | Automatically advances slides. |
| **Carousel speed (s)** | Seconds between slide transitions. Default is **2.5**. |
| **Loop items?** | When the carousel reaches the last slide, it starts again. Default is **Yes**. |
| **Number of visible listings** | How many cards show at once on desktop, tablet, and mobile. Defaults are **3**, **2**, and **1**. |
| **Show blank slides?** | When there are 3 or fewer listings, blank placeholder slides fill the carousel so it still looks balanced. Default is **Yes**. |
## **How Listings Are Chosen**
The **Find listings using** setting controls where the feed gets its listings.
| **Method** | **What it does** |
| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |
| **Filters** | You pick filters directly in the widget: listing types, categories, regions, tags, priority, hand-picked listings, and more. |
| **Explore page query URL** | You paste a URL copied from your Explore page after applying filters. The feed mirrors that exact search. |
### **Filter Options (Filters Method)**
| **Setting** | **What it does** |
| :--------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Filter by Authors** | Limit to listings owned by specific users. Enter user IDs separated by commas. |
| **Filter by Categories** | Show listings in selected categories. |
| **Filter by Regions** | Show listings in selected regions. |
| **Filter by Tags** | Show listings with selected tags. |
| **Filter by \[Custom Taxonomy]** | If you created custom taxonomies, each one gets its own filter. |
| **Filter by Listing Type(s).** | Limit to one or more listing types. This also controls which preview card design each listing uses. |
| **Filter by Priority** | Include **Normal**, **Featured**, **Promoted**, or **Custom** priority levels. Leave blank to include all. |
| **Or select a list of listings.** | Hand-pick specific listings by ID. Useful for a curated "Staff Picks" section. |
| **Order by** | Sort by **Date**, **A-Z**, **Rating**, **Random**, **Last modified date**, or **Included order** (matches your hand-picked list). Default is **Date**. |
| **Order** | **Ascending** or **Descending**. Default is **Descending**. |
| **Order by priority first?** | When on, featured and promoted listings appear before others, then the **Order by** rule applies. Default is **Yes**. |
| **Show badge for featured/promoted listings?** | Displays a badge on priority listings. Default is **Yes**. |
### **Explore Page Query URL Method**
This method is useful when your Explore page filters are complex and you want the feed to match them exactly.
1. Open your Explore page on the front end.
2. Apply the filters you want (listing type, category, location, sort order, etc.).
3. Copy the full URL from the browser address bar.
4. In the Listing Feed widget, set **Find listings using** to **Explore page query URL**.
5. Paste the URL into **Paste the URL here**.
Example URL: `https://yoursite.com/explore/?type=restaurants&category=italian&sort=latest`
The feed uses the same query engine as the Explore page, so results stay in sync with how Explore interprets those URL parameters.
## **Preview Cards and Listing Feeds**
Each listing in a feed renders using that listing's **preview card** design. Preview cards are configured per listing type under **WP Admin > Listing Types > \[Type] > Preview Card**.
What visitors see on each card depends on the listing type:
* Cover image or gallery style
* Fields shown (category, rating, price range, tagline, etc.)
* Quick View, bookmark, and compare icons (if enabled for that type)
If you filter by multiple listing types, each listing uses its own type's preview card design. Cards may look slightly different within the same feed.
## **Caching**
| **Setting** | **What it does** |
| :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------- |
| **Cache results for (in minutes)** | How long the feed reuses the same query results before refreshing. Default is **720** (12 hours). Set to **0** to disable. |
Caching applies to the initial server load when pagination is off. When pagination is enabled, visitors loading additional pages fetch fresh results via AJAX.
For faster card rendering site-wide, enable **Preview Card Caching** under **Theme Tools > Theme Options > Preview Cards**. This stores pre-built HTML for each preview card and speeds up listing feeds, Explore pages, and similar listings sections.
## **How the Pieces Fit Together**
A practical example for a restaurant directory homepage:
1. **Featured carousel**: Template **Carousel**, filter by **Priority** = **Featured**, **Listings per page** = 6, autoplay on.
2. **Newest listings grid**: Template **Grid**, filter by listing type **Restaurant**, **Order by** = **Date**, **Listings per page** = 9, 3 columns on desktop.
3. **Italian restaurants row**: Template **Grid**, **Find listings using** = **Explore page query URL**, paste the Explore URL filtered to the Italian category.
Each widget is a separate **27 > Listing Feed** block on the same Elementor page. They do not share settings.
## **Common Listing Feed Setups**
| **Site idea** | **Feed setup** |
| :-------------------------- | :-------------------------------------------------------------- |
| Business directory homepage | Carousel of featured listings + grid of newest listings by type |
| Category landing page | Grid filtered to one category, pagination enabled |
| Region page | Grid filtered to one region, sorted by rating |
| Curated "Editor's Picks" | Hand-picked listing list with **Included order** |
| Events site | Grid filtered to event listing type, ordered by date ascending |
| Multi-type showcase | Grid with no listing type filter, priority ordering on |
## **Helpful Tips**
* **Start with one listing type.** Filtering by a single type keeps preview cards visually consistent and makes troubleshooting easier.
* **Use Explore URLs for complex filters.** If a filter combination is hard to reproduce in the widget, set it up on Explore first, then paste the URL.
* **Disable isotope on uniform grids.** When all your preview cards are the same height, turn on **Disable isotope masonry?** for a noticeable speed boost.
* **Hand-pick with Included order.** When using **Or select a list of listings.**, set **Order by** to **Included order** so listings appear in the sequence you chose.
* **Random refreshes every few hours.** **Random** order uses a seed that changes roughly every 3 hours, so the same feed shows variety without shuffling on every page load.
* **Leave cache at default unless needed.** The 12-hour default works well for most sites. Lower it only if listings change frequently and you need feeds to update sooner.
* **Match pagination to page design.** **Load More** suits long scrolling pages. **Prev/Next** suits compact sections. **Pages** suits feeds where visitors expect numbered navigation.
## **Quick Reference**
| **I want to...** | **Go to...** |
| :------------------------------------- | :------------------------------------------------------------------------ |
| Add a listing feed to a page | Edit the page in Elementor, add **27 > Listing Feed** |
| Show only featured listings | Widget **Filter by Priority** = **Featured** |
| Mirror an Explore page search | **Find listings using** = **Explore page query URL**, paste the URL |
| Curate a specific set of listings | **Or select a list of listings.**, then **Order by** = **Included order** |
| Change how preview cards look | **WP Admin > Listing Types > \[Type] > Preview Card** |
| Speed up feed loading | **Theme Tools > Theme Options > Preview Cards** > enable caching |
| Bulk-configure feeds on taxonomy pages | MyListing Pro **Listing Feed Taxonomy Sync** module |