Skip to main content

Additional fitment selectors (Vehicles and fitments guide, Part 3)

A
Written by Anna Verbichenko

What are additional fitment selectors?

Beyond the basic Make/Model/Year/Submodel hierarchy, X-Cart supports additional fitment selectors that let customers further refine their search. These selectors appear on category pages after a customer has selected their vehicle.

Additional fitment selectors are built on vehicle configuration attributes imported from auto integrations. They act as extra filters that narrow down the product list based on vehicle-specific details.


Available selector types

Additional selectors fall into two groups: individual attributes and compound attributes.

Individual attributes

Selector

Description

Example Values

Drive Type

Drivetrain configuration

FWD, RWD, AWD, 4WD

Engine

Engine specification

2.0L 4-Cyl, 3.5L V6, 5.7L V8

Transmission

Transmission type

Automatic, Manual, CVT

Wheelbase

Wheelbase length

Short, Standard, Long

Brake System

Brake configuration

Disc/Disc, Disc/Drum

Steering

Steering system

Power, Manual

Spring Type

Suspension spring

Coil, Leaf

Compound (Composite) attributes

Some attributes are imported as compound values that combine two related specs into a single filter. This ensures only valid combinations appear (e.g., you won't see "4-door" with "Standard Cab" since that combination doesn't exist).

Compound Attribute

Components

Example Values

Body Type & Number of Doors

Body Type + Door Count

"Crew Cab Pickup, 4" / "Extended Cab Pickup, 4" / "Standard Cab Pickup, 2"

Bed Type & Length [inch]

Bed Type + Bed Length (inches)

"Fleetside, 97.6" / "Styleside, 78.9"

Bed Type & Length [cm]

Bed Type + Bed Length (metric)

"Fleetside, 247.9"

Note on body type synonyms: Different manufacturers use different names for the same body styles. X-Cart recognizes these equivalences:

  • Crew Cab = Super Crew

  • Extended Cab = Super Cab = King Cab = Access Cab

  • Standard Cab = Regular Cab

Compound attributes are created during import from SEMA Data API or CatalogRack ACES files. If either component of a compound attribute is missing in the source data, the compound attribute is not created.


How additional selectors work

  1. Data Source: Configuration attributes are imported from auto integrations (AutoSync, SEMA Data, ATD) when vehicles are pulled into your store. These attributes are stored as product-class-specific attributes (not global), grouped under "Fitment Details".

    • Featured Filter Setting: In the X-Cart admin under Cloud Search & Filters, each filter attribute has a "Featured filter" setting with the following options:

      Not set — Filter is not featured (appears in normal filter list)

    • Refine Your Search — Appears in the "Refine Your Search" block

    • Refine Your Fitment — Appears in the "Refine Your Fitment" block (always expanded)

    • Select Your Wheel Size — Appears in the wheel size selection block (for wheel/tire stores)

    • Select Your Tire Size — Appears in the tire size selection block (for wheel/tire stores)

  2. Filter Display Modes: Each filter can be configured with one of these display modes:

    • Radio Buttons — Select one value (recommended for "Refine Your Fitment" block)

    • Checkboxes — Select multiple values

    • Drop-down List — Select one value from a dropdown

Customer Experience

  • Customer selects vehicle (Make → Model → Year → Submodel)

  • The "Refine Your Fitment" block appears with additional selectors (always expanded)

  • Customer picks Body = "Crew Cab Pickup, 4", Drive Type = "4WD"

  • Product list narrows to show only compatible parts

  • These selectors do NOT force user selection — customers can skip them and shop freely


Setting up additional selectors

  1. Import vehicle configurations

    Ensure your auto integration imports configuration attributes. AutoSync does this automatically; SEMA Data imports compound attributes via ACES files (SEMA Data API and CatalogRack ACES).

  2. Configure Cloud Search & Filters

    Go to Store Setup → Cloud Search & Filters. For each attribute you want to promote, set the Featured filter value (e.g., "Refine Your Fitment").

  3. Choose display mode

    For each featured filter, select Radio Buttons, Checkboxes, or Drop-down List.

  4. Assign to categories

    Optionally limit certain selectors to specific product categories (e.g., show "Bed Type & Length" only in the Truck Accessories category).

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!


Did this answer your question?