New recommendations-first product filter layout (opt-in)
New recommendations-first product filter layout (opt-in)
A new product/job-details filter layout is available on the product landing,
selected with the existing products.he_product_filters_layout partner setting
via a new value: "v3". It makes recommended channels the primary content
and presents the two search modes as tabs.
This is opt-in. The default and existing layouts are unchanged: partners
without the setting (or on "v1"/"v2") see exactly what they see today.
The v3 layout
- Recommended, free add-on, and relevant channel sections are the main content.
- The filter form is always visible (no collapsible "Channel Filters"
accordion to expand) and splits the two search modes into tabs instead of
an "Or" divider:
- Get recommendations (default tab) — job title, job function, industry, and location, laid out as a compact horizontal search bar, to get a recommended media mix.
- Search by product — search by a specific product/channel name.
Splitting the modes into tabs makes it clear that you use one or the other, which is how the search has always worked: a product-name search and the job-detail filters are alternative paths, not combined. Switching back to the Get recommendations tab clears the product name so the job-detail filters drive the results again.
Search behaviour is unchanged across all layouts — product-name search, the
job-detail filters, the channels returned, and the "Sort By" / "Filter By"
controls all work exactly as before. v3 only changes presentation.
he_product_filters_layout
settings.products.he_product_filters_layout: "v1" | "v2" | "v3""v1"(default when unset): collapsible Channel Filters accordion."v2": horizontal filter toolbar."v3": the recommendations-first tabbed layout described above.
"v3" is purely additive — "v1" and "v2" behave exactly as before, and the
default remains "v1".
Backwards compatibility
- No SDK function, getter, setter, property, or event was removed or renamed.
- All widget element
id,class, anddata-*attributes used forhapi.ui.*targeting are preserved (including the filter field selectors and thehapi__products-filters-accordionwrapper class, which wraps the form in every layout). Existing UI customizations continue to match. - No translation keys were removed.
I18n
The following i18n translations have been added (used by the v3 tabs):
| Key | "en" value | "de" value | "nl" value | "fr" value | "es" value | "it" value |
|---|---|---|---|---|---|---|
| products.search-mode.recommendations | Get recommendations | Empfehlungen erhalten | Aanbevelingen ophalen | Obtenir des recommandations | Obtener recomendaciones | Ottieni consigli |
| products.search-mode.product | Search by product | Nach Produkt suchen | Zoeken op product | Rechercher par produit | Buscar por producto | Cerca per prodotto |
The existing products.filters.name-placeholder value was also updated to an
example list (e.g. Indeed, LinkedIn, Reed, Totaljobs…).
The product filter apply button label (products.filters.apply-filters) was
also reworded from "Apply Filters" to "Search" (all locales) to better describe
its action; the key is unchanged, so existing translation overrides keep working.