Skip to content

How to display Fitment Table for wheel and tire products

Since fitment search for wheels/tires works in a special way (search by wheel/tire vehicle attributes), it is not possible to get fitments for a specific wheel/tire using the usual mechanisms.

For this, there is a separate plugin - WheelTireFitmentTablePlugin.

See more details here https://github.com/Convermax/SiteSearch/pull/4254


The wheel/tire fitment table is a quite “expensive” performance feature. Therefore, it should not be connected without special necessity.

If a store does not use all the basic wheel attributes for ymm search (bolt pattern, diameter, width, offset, bore) - this is a sign that you should not enable the table.

Because the fewer attributes are used for matching, the more fitments for the wheel we will get.

For example, very often the wheel_bore field is disabled for clients due to poor coverage of wheels by this attribute, so as not to use it in wheel ymm search. If you enable the fitment table for such a client, then most likely the product page will become very slow - long processing in the plugin on the server/long rendering of a huge number of elements in the DOM on the client.


How to connect

1. Connect WheelTireFitmentTablePlugin

2. Check the configuration of wheel/tire fields in the schema:

  • ensure that Stored: true is set for fields wheel_bolt_pattern_mm, wheel_size, wheel_offset, wheel_bore, tire_size (to retrieve values in the plugin from the product).

  • set Multivalued: true for fields wheel_bolt_pattern_mm, tire_size, if they can contain multiple values (to retrieve all, not just the first one, in the plugin).

    It’s necessary to see where and how attributes are retrieved from (parsing/metafields, etc.).

3. If the store does not use WheelTireFitmentHelper for indexing wheel/tire fitments, then it is necessary