Vehicle Search Intelligence (VSI) User guide

Overview

Vehicle Search Intelligence (VSI) enhances Magento product discovery
by automatically understanding Year, Make and Model information
from search queries and filtering compatible products.

Features

✓ Natural language search
✓ Automatic vehicle detection
✓ Selected vehicle persistence
✓ Category filtering
✓ Search result filtering
✓ Selected vehicle block
✓ Merchant configuration options

Installation

Install using Composer

From the CLI, run the following commands to install the Vehicle Search Intelligence module.

  1. Run composer: composer require globalecomservices/module-vsi
  2. Run Magento install/upgrade scripts: php bin/magento setup:upgrade
  3. Compile dependency injection: php bin/magento setup:di:compile
  4. Deploy static view files (production mode only): php bin/magento setup:static-content:deploy
  5. Flush Magento cache: php bin/magento cache:flush

Install manually

  1. Upload module to:
    • app/code/Globalecomservices/VSI
  2. Enable Module:
    • php bin/magento module:enable Globalecomservices_VSI
  3. Run Magento install/upgrade scripts:
    • php bin/magento setup:upgrade
  4. Compile dependency injection:
    • php bin/magento setup:di:compile
  5. Deploy static view files:
    • php bin/magento setup:static-content:deploy
  6. Flush Magento cache:
    • php bin/magento cache:flush

Fitment Index

To Build Fitment Index, run the following command in CLI
php bin/magento vsi:fitment:index

Disable Full page cache

php bin/magento cache:disable full_page

Configuration

Admin -> Stores
→ Configuration
→ Global eCom
→ Vehicle Search Intelligence

Settings

Settings Description

SettingDescription
Enable VSIMaster switch
Enable Search IntelligenceDetect vehicle from searches
Enable Category FilteringFilter category products
Enable Search FilteringFilter search results
Show Selected Vehicle BlockDisplay selected vehicle

Recommended Settings

Enable VSI = Yes
Enable Search Intelligence = Yes
Enable Category Filtering = Yes
Enable Search Filtering = Yes
Show Selected Vehicle Block = Yes

Testing

Vehicle Search Intelligence – Search Flow

Vehicle Search Intelligence by Global eCom

Example Searches

Honda Civic 2020 brake
brake for Honda Civic 2020
2027 Mercedes-Benz G63 AMG brake pads
BMW X3 2026 spark plugs

Verify Test Results

Vehicle selected (Natural search)


Vehicle block displayed


Category filtering works

Category Products for fitment example 2020 Honda Civic


Search filtering works:

For any search, Vehicle Search Intelligence remembers your selected vehicle.

Example 1: brake

For any search, Vehicle Search Intelligence remembers your selected vehicle.

Example 2: Oil filter


Clear vehicle works

Clear Action

Vehicle Clear action Results:

Vehicle block is not displayed; All products are shown. No vehicle selected.

— End of Testing —

Questions

If you have any questions or issues, please contact us –Technical support 

FAQ (Frequently Asked Questions)

What does Search Intelligence do?

It enhances Magento product discovery by automatically understanding Year, Make and Model information from search queries and filtering compatible products.

Example searches:

Honda Civic 2020 brake
brake for Honda Civic 2020
2027 Mercedes-Benz G63 AMG brake pads

Why are products not filtering?

Checklist:

✓ VSI enabled in Extension Configuration
✓ Category Filtering enabled
✓ Search Filtering enabled
✓ Vehicle selected
✓ Fitment index built

When should I rebuild the fitment index?

php bin/magento vsi:fitment:index

Run after:

  • importing products
  • updating fitment attributes
  • changing vehicle assignments

Does Magento reindex run VSI?

Answer: No.
Run:
php bin/magento vsi:fitment:index

Why do I see all products?

Possible causes:

Vehicle not selected
Category Filtering disabled
Search Filtering disabled
Fitment index outdated

Does VSI work with Full Page Cache?

V1 supports stores with FPC disabled on vehicle-aware pages. Additional caching strategies will be enhanced in future versions.

Which search phrases are supported?

Examples:

Honda Civic 2020 brake
brake for Honda Civic 2020
2027 Mercedes-Benz G63 AMG brake pads
BMW X3 spark plugs

Why is only one product showing?

VSI filters products based on the currently selected vehicle and fitment assignments.