What are additional fitment selectors?
Beyond the basic Make/Model/Year/Submodel hierarchy, some automotive products depend on more specific vehicle configuration details — for example, a part may only fit a truck with a Crew Cab body and 4 doors, or a specific bed length. X-Cart supports importing this configuration data and turning it into extra filters (“additional fitment selectors”) that customers can use alongside standard vehicle selection.
Where this data comes from
Additional fitment selectors are built from vehicle configuration data supplied by your auto integration:
SEMA Data API provides the full set of configuration attributes (see the table below).
CatalogRack (ACES flat files) provides a narrower set — only Body Type and Bed Type data.
With the SEMA Data API, this data initially arrives packed into a single field called “FitmentNotes” (for example: BodyNumDoors: 4; BodyType: Crew Cab Pickup; Region: United States;). X-Cart parses this field during import and extracts the individual values listed below.
Extracted values are stored as product class attributes (not global attributes — different product classes can have different fitment attributes), grouped together under “Fitment Details”.
Available attributes
Individual attributes
Attribute | Example values | Available from |
Body Type | Crew Cab Pickup, Extended Cab Pickup | SEMA Data API, CatalogRack |
Body Num Doors | 2, 4 | SEMA Data API, CatalogRack |
Bed Type | Fleetside, Styleside | SEMA Data API, CatalogRack |
Bed Length [inch] | 76.3, 97.6 | SEMA Data API, CatalogRack |
Bed Length [cm] | 193.8, 247.9 | SEMA Data API, CatalogRack |
Drive Type | 2WD, 4WD | SEMA Data API |
Wheelbase [inch] | 140.0, 160.5 | SEMA Data API |
Wheelbase [cm] | 355.6, 407.7 | SEMA Data API |
Front Spring | (varies by vehicle) | SEMA Data API |
Rear Spring | (varies by vehicle) | SEMA Data API |
Position | Front, Rear | SEMA Data API |
Compound attributes
Some attributes are also imported as compound values that combine two related specs into a single filter. This ensures only valid combinations appear (for example, you won’t see “4-door” paired with a body type that doesn’t actually have 4 doors).
Compound attribute | Components | Example values |
Body Type & Number of Doors | Body Type + Body Num Doors | “Crew Cab Pickup, 4” / “Extended Cab Pickup, 2” |
Bed Type & Length [inch] | Bed Type + Bed Length [inch] | “Fleetside, 97.6” / “Styleside, 78.9” |
Bed Type & Length [cm] | Bed Type + Bed Length [cm] | “Fleetside, 247.9” |
If either component of a compound attribute is missing in the source data, the compound attribute is not created for that product.
In Cloud Search & Filters
Once imported, both individual and compound attributes become filters in Cloud Search & Filters.
For example, to see the Body Type filters, go to Store > Search & Filters, open the Filters tab, and search for "body":
In this example, searching for "body" finds three filters: "Body Type & Doors", "Body Num Doors", and "Body Type" — the individual attributes and the compound attribute built from them, shown together.
See Setting up additional selectors below for how to configure these filters.
How additional selectors work
Once the attributes are imported, you can choose to display any of them as a filter on the storefront. Where a filter shows up and how it looks is controlled by two settings — see Setting up additional selectors below.
From a customer’s point of view, here’s what using these selectors looks like:
Customer goes to a certain category and selects their vehicle (either uses the SELECT YOUR VEHICLE block to select Make → Model → Year → Submodel, or picks a vehicle from My Garage). The product list narrows down to vehicle-compatible parts right away.
If any of these attributes still vary among the matching products, the “Refine Your Fitment” block appears — it’s always expanded, so customers see it right away. Only attributes that still have more than one possible value are shown — for example, the block might show just “Body Type” if every matching product already shares the same Drive Type and door count.
Customer picks a value, for example Body Type = “Crew Cab Pickup”.
The product list narrows down further to items matching that value.
Example:
Say your vehicle is a CHEVROLET Silverado 2500 HD 2015 High Country. You select it from My Garage and open the "Floor Liner" category. The category shows 21 products compatible with your vehicle.
You also see the "Refine Your Fitment" block with a Body Type selector. This means not all 21 listed products are actually guaranteed to fit your vehicle — for a product to be a confirmed match, its Body Type must match your vehicle's. Expanding the Body Type field shows the available options: "Crew Cab Pickup", "Extended Cab Pickup", and "Standard Cab Pickup". Say your vehicle's Body Type is "Standard Cab Pickup". Once you select it in the Refine Your Fitment block, the product list narrows down to just 2 products. This way, the additional selector helps you narrow the category down to only the products that are confirmed to fit your vehicle.
Additional fitment selectors also work without a vehicle selected. In that case, the product list isn't pre-filtered by vehicle compatibility.
Depending on which filters are configured and which products happen to be in a given product list, the "Refine Your Fitment" block can include more than one filter. For example, in our demo store, the same "Floor Liner" category — without any vehicle selected — shows a "Refine Your Fitment" block with both individual attributes (Body Num Doors, Body Type, Drive Type) and the compound one (Body Type & Number of Doors).
Customers are never required to use these selectors — they can ignore them and keep browsing normally.
Setting up additional selectors
Import vehicle configurations
Make sure your auto integration imports configuration attributes: SEMA Data imports the full set via ACES files (SEMA Data API), CatalogRack imports Body Type and Bed Type only, also via ACES files.
Configure Cloud Search & Filters
Go to Store → Search & Filters, switch to the Filters tab. For each attribute you want to promote, click it to open its settings panel:
Set its Featured filter value:
Not set — the filter is not featured; it appears only in the normal filter list.
Refine Your Search — the filter appears in the “Refine Your Search” block.
Refine Your Fitment — the filter appears in the “Refine Your Fitment” block (always expanded).
Select Your Wheel Size — the filter appears in the wheel size selection block (wheel/tire stores).
Select Your Tire Size — the filter appears in the tire size selection block (wheel/tire stores).
Choose its Display mode (how it should look to customers):
Radio Buttons — customers select one value (recommended for the “Refine Your Fitment” block).
Checkboxes — customers can select multiple values.
Drop-down List — customers select one value from a dropdown.
Range — customers pick a value range using a min–max slider (recommended for numeric attributes with many distinct values, such as Bore [mm] and Offset [mm] in Wheel & Tire fitment — see Wheel & Tire fitment (Part 4)).
The same settings panel also lets you:
Rename the filter — edit the Display name field to change how it’s labeled to customers, independent of the underlying attribute name.
Set how multiple selected values are combined — the Products must match setting controls whether a matching product must have any or all of the values a customer selects (for filters where customers can select more than one value, such as Checkboxes).
Manage the filter’s values — under Filter Values, you can search for a specific value, change the sort order, enable or disable individual values (or use the “⋮” menu for Enable all / Disable all), and edit or delete individual values using the pencil and trash icons.
Note: This feature is available only for X-Cart Auto stores (stores with automotive add-ons enabled).
Can't find answers you're looking for?
Email us at support@x-cart.com. We will be happy to help!
Related articles