Help buyers find exactly what they’re looking for with powerful search and filtering. The [wbam_classified_search] shortcode adds a search form to any page on your site. Visitors can search listings by keyword, category, location, and price range.
Adding the Search Form
Add the shortcode to any page, post, or widget area:
[wbam_classified_search]
This displays a search form with fields for keyword, category, location, and price range. When submitted, it takes visitors to your Browse Classifieds page with filtered results.
Shortcode Parameters
Customize the search form with these parameters:
| Parameter | Default | Description |
|---|---|---|
layout |
horizontal |
Form layout: horizontal (all fields in a row) or vertical (fields stacked) |
show_category |
true |
Show the category dropdown filter |
show_location |
true |
Show the location filter |
show_price |
true |
Show the price range filter |
action |
Browse page URL | Where to send search results |
Layout Examples
Horizontal search bar (good for page headers and hero sections):
[wbam_classified_search layout="horizontal"]
Vertical search form (good for sidebars and narrow columns):
[wbam_classified_search layout="vertical"]
Keyword search only (removes all filters for a minimal look):
[wbam_classified_search show_category="false" show_location="false" show_price="false"]
Category-specific search (sends results to a different page):
[wbam_classified_search action="/vehicles/" show_location="false"]
Common Placement Ideas
Homepage Hero Search
Place a large horizontal search form above the fold on your homepage to make it immediately obvious that your site is a classifieds marketplace.
Sidebar Search Widget
Add the shortcode to a Text widget in your sidebar for persistent search access across all pages.
Browse Page Header
Add it above your [wbam_browse_classifieds] shortcode for an integrated search-and-browse layout.
Category Pages
Create dedicated category landing pages with a pre-filtered search form pointing to that category’s results.
How Search Results Work
When a visitor submits the search form, they are taken to the Browse Classifieds page with their search terms applied as filters. The URL updates to reflect the active filters, so results are shareable and bookmarkable.
Visitors can refine their search further on the results page using the filter sidebar.
Next Steps
- Setting Up Classifieds — enable and configure the module
- Seller Profiles — public seller profile pages