Job Search Filter Shortcode

[jobmate_job_search_filter] renders a search form with keyword, location, and category fields that submits to your jobs page. It is useful on a homepage or landing page.

Basic usage

[jobmate_job_search_filter]

The form submits to the page configured as the WP Job Manager jobs page. If that page is not set, the addon falls back to a page with the jobs slug.

Attributes

Attribute	Default	Description
keywords	(empty)	Prefills the keyword field. Overridden by a search_keywords query string value.
location	(empty)	Prefills the location field. Overridden by a search_location query string value.
selected_category	(empty)	Preselects a category by term ID. Overridden by a search_category query string value.
show_categories	true	Shows the category dropdown. Automatically hidden when WP Job Manager categories are disabled.
hide_labels	false	Hides the field labels and relies on placeholders.
form_layout	vertical	Layout modifier applied as a CSS class on the form.
heading	(empty)	Optional heading shown above the form.
background_color	(empty)	Inline background color for the form.
button_color	(empty)	Inline background color for the submit button.
label_color	(empty)	Inline color for the heading and labels.
remove_border	false	Removes the form border when set.

Example

[jobmate_job_search_filter heading="Find your next role" form_layout="horizontal" hide_labels="true"]

Notes

• The category dropdown appears only when the job_listing_category taxonomy has terms and the current page is not already a category archive.
• Keyword, location, and category values in the URL query string take priority over the shortcode attributes, so the form stays in sync with an active search.
• Developers can change the defaults with the jobmate_job_manager_output_search_defaults filter.