Carfitly – AI Auto Parts Fitment Assistant

Carfitly adds an AI-powered parts assistant to your WooCommerce store. Shoppers describe their vehicle in plain language - "engine oil for a BMW 320d 2016" - or enter an OE part number, and receive product recommendations drawn exclusively from your own catalog, with your best sellers first. Why parts stores choose Carfitly

• Grounded in your catalog. The assistant can only recommend products that exist and are in stock in your store. It never invents products, prices or availability.
• OE-number exact matching. When a shopper enters a part number, Carfitly matches it against your product titles and SKUs deterministically, with normalization ("06L 115 562 B" matches "06L115562B"). Part-number questions are answered by exact matching - never by AI guessing.
• Careful fitment language. When compatibility cannot be verified from your product data, the assistant says so and advises the shopper to verify by OE number, instead of overstating certainty.
• Best sellers first. When several products match, your store's most purchased items are recommended first.
• Your AI provider, your key. Connect OpenAI, Anthropic (Claude), Google Gemini, DeepSeek, xAI (Grok), Zhipu (GLM), Moonshot (Kimi), or any OpenAI-compatible endpoint. You pay your provider directly; API keys are stored encrypted in your database and are never routed through Carfitly's servers.
• Multilingual. Widget interface in English, Lithuanian, German, Polish, Russian and Latvian - and the assistant replies in whatever language the shopper writes.
• Flexible placement. A floating assistant dock, a compact inline launcher via the [carfitly_chat] shortcode, or a fully embedded panel with [carfitly_chat mode="full"].
• Add to cart from the chat. Shoppers add recommended products without leaving the conversation.
• Widget customization. Assistant title, welcome message, input placeholder, dock position and full widget colors.

Conversation insight Every conversation is stored locally in your own WordPress database - nothing is sent to Carfitly. The Conversations screen shows the full history and statistics, chat-assisted revenue (order value that followed a chat interaction in the last 30 days) and the lost-demand report - every question that found no matching product, grouped and counted, so you know what to stock next. Free — everything in this plugin, no limits

• Unlimited storefront conversations
• Seven AI providers plus a custom endpoint — bring your own key
• Natural-language product search and careful fitment guidance
• Exact OE/OEM part-number matching
• Add to cart directly from the chat
• Chat-assisted revenue tracking and the lost-demand report
• Complete conversation history and statistics
• Full widget customization and six interface languages

Everything above is fully functional in this free plugin — no locked features, no usage caps, no time limits. Carfitly Pro — a separate product from carfitly.com Carfitly Pro is a separately distributed version for stores that want zero setup:

• Managed Carfitly AI — the assistant runs on Carfitly's own AI service: no API key, no provider account, nothing to configure (early access rolling out)
• Fair-use conversations included — no separate AI provider bill
• Priority email support with replies within six working hours
• Seven-day free trial

Pro is sold and delivered from carfitly.com; it is not required for anything this plugin does.

0.7.0

• Fitment transparency: before recommending, the assistant now shows the vehicle it understood, any assumption it made (engine variant, model generation), and a confidence level. Deterministic OE matches are marked "verified" by the matching engine itself - never claimed by the AI.
• New understanding strip in the widget, translated into all six interface languages.

0.6.2

• All SVG icon output in the admin screen now passes through wp_kses with a strict allowlist; transient keys use the full carfitly_ prefix; WooCommerce dependency declared via the Requires Plugins header.

0.6.1

• Hardened output escaping in the admin screen; documented the first-party cfy_assist attribution cookie in the readme.

0.6.0

• All functionality is now free and fully unlocked in the WordPress.org distribution: add to cart from the chat, full conversation history and statistics, chat-assisted revenue, lost-demand report, and complete widget customization. No feature limits, no upgrade prompts.
• All licensing/SDK code removed from the WordPress.org build (it now lives only in the separate Pro distribution on carfitly.com).
• External services disclosure expanded: named Terms of Service and Privacy Policy links for every supported AI provider.
• Uninstall cleanup via uninstall.php (options + local conversation table).

0.5.3

• Pro: widget customization - assistant title, welcome message, input placeholder, floating dock position (left/right), full widget colors (background, messages area, text, customer bubble).
• Design: theme-isolation layer so the widget looks identical in any theme; compact add-to-cart pill; composer alignment fixes.

0.5.0

• Pro: Add to cart directly from the chat (simple products, WooCommerce AJAX).
• Pro: Chat-assisted revenue - orders placed after a chat interaction are attributed and summed on the Conversations screen.
• Pro: Lost-demand report - questions that matched no product, grouped by frequency.
• Free: lost-demand counter teaser on the Conversations screen.

0.4.11

• WordPress.org build now ships without any bundled licensing SDK - the free plugin makes no calls to Carfitly or Freemius.
• Coding-standards pass: prepared identifier placeholders, stricter input sanitization, no heredoc.
• Requires WordPress 6.2 or newer.

0.4.6

• Plugin renamed to "Carfitly".
• Attribution link in the widget is now opt-in and disabled by default.
• Documentation: external services disclosure, expanded FAQ, professional description.
• Compatibility: tested up to WordPress 7.0.

0.4.x

• Introduced the separately distributed Pro build (sold and delivered from carfitly.com, outside WordPress.org).
• Conversations screen: locally-stored chat log with statistics.
• OE-number exact matching with normalization; verified-match badges.
• Provider-level JSON output mode and robust reply parsing.
• Compact launcher, single brand mark, tightened widget UX; official logo across widget and admin.

0.3.0

• Rebuilt storefront UX: assistant dock, dropdown, mobile bottom sheet, redesigned admin.

0.1.0

• First release: grounded chat endpoint, 8 AI providers + custom, floating and inline widgets, popularity-sorted product cards, per-IP rate limiting, encrypted key storage.