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

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

Example Searches

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

Search Flow

Customer Search
↓
Vehicle Parser
↓
Vehicle Resolver
↓
Vehicle Selection
↓
Product Filtering
↓
Vehicle-Aware Browsing

Recommended Testing

Honda Civic 2020 brake
brake for Honda Civic 2020
BMW X3 2026 spark plugs

Verify

Vehicle selected
Vehicle block displayed
Category filtering works
Search filtering works
Clear vehicle works