baFFLe Search™ requires a paid subscription to the baFFLe Search™ data service. The service supplies the nationwide FFL dealer list and building-level map pins that the dealer search runs on. The plugin is the client for that service: it downloads the list to your own site and searches it there.
What the service adds over the raw ATF file
ATF publishes its dealer list as a plain text file. The data service does the work of turning that file into something a checkout can use, and repeats it every month:
- Cleaned. Records are normalized and checked, so bad rows never reach your store.
- Deduplicated. One row per active license.
- Rooftop-geocoded. Dealers are matched to their actual building, so the map shows the shop and not the middle of a ZIP code. The geocoding runs on our side, across the whole country.
- Signed and published monthly. Each list carries a signature that the plugin verifies before using it. A list that fails the check is refused.
What the plugin does
When a cart holds a product you have flagged as an FFL item (a serialized firearm, frame, receiver, suppressor or other NFA item), the buyer searches the dealer list by ZIP code and distance, sees the dealers on a map, and chooses one. The shipping address is pinned to that dealer's licensed premises and can't be edited by the buyer. The order then waits in a dedicated
Awaiting FFL verification status until you confirm the dealer's license and press
Mark FFL verified on the order screen.
- ZIP-radius search (1, 5 or 10 miles) over the Census ZIP table that ships with the plugin, with a map of the results. Search runs on your own site.
- Ship-to locked to the dealer. The buyer still enters their own billing address.
- Hold for verification. FFL orders stop in Awaiting FFL verification; the buyer gets a "we're confirming your dealer" email; you see the dealer's license number, type, expiry month and warnings (license expired, dealer missing from the latest list, address changed) in an FFL Transfer box on the order. Optionally require an uploaded copy of the dealer's license before an order can be marked verified.
- Rules you set: which license types may receive (01, 02, 07 and the rest), blocked states, per-state notes shown to the buyer, in-store pickup for FFL items, your own checkout notice and email text.
- Setup wizard under WooCommerce → FFL Setup. Every step can be skipped and run again later.
Without an active subscription
Product flagging, the FFL requirement at checkout, the verification hold, the order screen, in-store pickup and every non-firearm product keep working with or without a subscription. What a subscription pays for is the list:
- An out-of-date dealer list is not safe to ship against, so the list stops updating when a subscription ends and is removed within 30 days of its last update, the last time the service confirmed it. Until then, dealer search runs on the list you already have.
- You get one warning email 17 days after that last update. The plugin asks the service once more before it removes a list, and a removed list comes back with the next update once your subscription is active.
- A store that never had a license has no dealer list, so there is nothing to search. Checkout tells buyers to contact the store.
What it is not
You verify licenses. baFFLe Search™ shows you the receiving dealer's details and links you to ATF eZ Check, but
you confirm the license and complete the transfer under your own procedures. The plugin is a compliance aid, not legal advice. No plugin can provide 100% compliance, and it does not replace Form 4473, NICS, your bound book or your state's rules. The dealer list does not carry SOT status: for NFA items you confirm the receiving dealer's SOT yourself.
Requirements
- A baFFLe Search™ subscription. Buy one here, or from the plugin's FFL License screen.
- WooCommerce 9.0 or newer with the block checkout (the Checkout block). The classic shortcode checkout is not supported: a cart holding an FFL item is refused there and the buyer is sent to the checkout page.
- PHP 8.1 or newer.
baFFLe Search™ is published by Quartermaster Arms and is not affiliated with or endorsed by ATF.
Terms of Service ·
Privacy Policy