Frequently asked questions
Everything you need to know about BOMexplorer
Getting started
What file formats does BOMexplorer accept?
What file formats does BOMexplorer accept?
BOMexplorer accepts KiCad BOM CSV exports (Symbol Fields Table), Altium BOM exports, and generic CSV formats. Drag-and-drop your file — intelligent column header mapping handles Refs, RefDes, Designator, Qty, MPN, Value, and more automatically.
Which KiCad versions are supported?
Which KiCad versions are supported?
BOMexplorer works with BOM CSV files from KiCad 5.0 and later. It also supports Altium BOM exports and any generic CSV with recognizable column headers.
How do I get started?
How do I get started?
Simply upload your BOM CSV file. BOMexplorer auto-detects columns, matches parts against providers, and presents results in seconds. No configuration needed to start.
Providers & matching
Which providers are supported?
Which providers are supported?
BOMexplorer integrates with 6 providers: Nexar, OEMSecrets, DigiKey, Mouser, FindChips, and NextPCB. Free tier uses one configured provider. Pro tier accesses all 6 with automatic fallback.
How does provider fallback work?
How does provider fallback work?
If the active provider returns no results for a component, BOMexplorer automatically tries the next configured provider in sequence. This continues until a match is found or all providers are exhausted. Admins can configure the provider priority order.
What is a 'confidence score'?
What is a 'confidence score'?
Confidence badges indicate match type: Exact MPN (highest confidence), Parametric match, Keyword match, AI-suggested, and Unmatched. Scores help you quickly assess match reliability at a glance.
How does the matching algorithm work?
How does the matching algorithm work?
Hierarchical matching: (1) Exact MPN match → (2) Hyphen-stripped MPN match → (3) Distributor part number match → (4) Keyword search. Multi-stage matching maximizes coverage across providers.
AI features
What is AI Assist?
What is AI Assist?
AI Assist has two components: (1) Natural language BOM filtering — type plain English queries like 'show me capacitors under $0.10' to highlight matching rows, and (2) AI part classification — Claude-powered classification for components that traditional matching can't handle.
How does AI part classification work?
How does AI part classification work?
When a component can't be matched through normal means (crystal symbols, fiducials, mounting holes, copper-only net ties), Claude AI classifies the component and generates a provider-specific query to try to find a match. Unmatchable values are added to the smart skip list automatically.
What is the smart skip list?
What is the smart skip list?
BOMexplorer automatically skips known unmatchable values like TestPoint, LED, Fiducial, MountingHole unless an explicit MPN is provided. This prevents false matches and saves API calls.
How many AI Assist lines do I get?
How many AI Assist lines do I get?
Free tier: 50 AI Assist lines per month. Pro tier: 500 AI Assist lines per month. Both natural language query and AI classification count toward this limit.
Monitoring & alerts
How often are parts re-checked?
How often are parts re-checked?
Free tier: manual refresh only. Pro tier: automated overnight re-query via Celery background job. All active BOM lines are re-checked for price and stock changes while you sleep.
What supply chain flags are detected?
What supply chain flags are detected?
Out-of-stock, low-stock, price spikes, end-of-life (EOL) notices, and lead-time increases. Each flag has a lifecycle: Open → Watching → Ignored → Resolved with snooze support.
How are alerts delivered?
How are alerts delivered?
Alerts appear in-app with visual flag indicators. Pro tier also receives morning digest emails summarizing all new flags detected overnight. Configure thresholds per project in preferences.
Can I set custom stock thresholds?
Can I set custom stock thresholds?
Yes, per-project overrides let you set custom stock level thresholds for alerts. Global preferences define default behavior, and projects inherit those values unless overridden.
Substitution & alternatives
How do I swap a part?
How do I swap a part?
Navigate to the Alternatives page for any BOM line. All ranked candidate parts are shown with pricing, stock, and distributor info. Click swap on any alternative and confirm — the substitution is recorded with timestamp and reason.
Can I see substitution history?
Can I see substitution history?
Yes. Each BOM line has a collapsible substitution timeline showing all swaps with the old MPN, new MPN, timestamp, and trigger reason. Full audit trail for compliance.
What is part ranking?
What is part ranking?
When multiple alternatives exist, BOMexplorer ranks them by suitability. AI-suggested candidates are marked with a badge. Rank 2+ results are automatically stored as alternatives for future reference.
Export
What export formats are supported?
What export formats are supported?
Three formats: (1) CSV — UTF-8 BOM, comma-separated, (2) Excel — bold headers, auto-sized columns, sheet named 'BOM', (3) Manufacturer CSV — 12-column format ready for assembly partners.
Will locked parts survive re-export?
Will locked parts survive re-export?
Yes. Locked parts are preserved across re-matching and re-export. Use row locking to freeze confirmed parts so they never change unexpectedly.
Billing & plans
Is there a free tier?
Is there a free tier?
Yes, always free. Includes 3 projects, 50 BOM lines per project, single provider, 50 AI Assist lines/month, CSV & Excel export. No credit card required.
What does Pro include?
What does Pro include?
Unlimited projects, unlimited BOM lines, all 6 providers, 500 AI Assist lines/month, natural language BOM query, overnight supply chain monitoring, email alerts, part substitution history. $19/month via Paddle.
How is payment processed?
How is payment processed?
All Pro subscriptions are processed securely through Paddle. Supports cards, Apple Pay, and more. Cancel anytime from preferences — access continues until billing period ends.
Do you offer discounts?
Do you offer discounts?
Contact us for academic and open-source project discounts. We support educators and community builders with special pricing.
Preferences & configuration
What can I configure in preferences?
What can I configure in preferences?
Global preferences: distributor order, excluded distributors, preferred manufacturers, accept generic passives, lifecycle policy, currency, region, grade. Per-project overrides: distributor restrictions, quantity, grade, lifecycle policy (null values inherit from global).
Privacy & data
Do you store my BOM data?
Do you store my BOM data?
Your BOM files are processed in real-time. Raw CSV rows are preserved as JSON per line to enable re-matching without re-import. Create an account to save projects permanently. We only retain the minimum data necessary for providing the service.
Is my component data shared with providers?
Is my component data shared with providers?
No. We query providers' public APIs and websites but never share your BOM data with them. Your component lists remain private.
How do you handle data security?
How do you handle data security?
JWT authentication with short-lived access + refresh tokens in httpOnly cookies. All data is encrypted in transit and at rest. Password reset uses tokenised email links with 24h expiry and always-200 responses to prevent email enumeration.
Still have questions?
Contact Us