WooCommerce Plugin Setup

Getting Started

Setting up FFL finder on your WooCommerce store takes just a few steps:

1. Sign up for CloudFFL

Create your CloudFFL account to get your API key. Plans start at $69/month and include the WooCommerce plugin at no additional cost.

Create your account →

2. Install the plugin

In WordPress admin, go to Plugins → Add New and search for "CloudFFL". Click Install and then Activate. The plugin is free on WordPress.org—your API subscription unlocks the FFL data.

3. Configure your API key

Go to WooCommerce → CloudFFL Finder → General tab and enter your API key. The plugin will verify connection automatically.

4. Mark products as FFL-required

Edit your firearm products and check the "Requires FFL" box in the product data panel. For bulk configuration, set FFL-required at the category level—all products in that category will inherit the setting.

Product-level setting:

Category-level setting:

5. Test checkout

Add an FFL-required product to your cart and go through checkout. The FFL finder should appear, allowing you to search and select a dealer.

Ammo Gate Configuration

Some states like California require ammunition to be transferred through an FFL. The CloudFFL plugin includes Ammo Gate to handle these rules:

• Select which product categories contain ammunition
• Select which states require FFL transfer for ammo
• Customers in restricted states automatically see the FFL finder for ammo orders
• All configuration done in the Ammunition tab of CloudFFL Finder settings

Ammo Gate state configuration:

Ammo Gate is included with your CloudFFL API subscription—no additional cost.

Configuration Options

Plugin settings are managed in WooCommerce, while FFL filtering is controlled through your CloudFFL dashboard.

Log into your CloudFFL dashboard to manage FFL filtering options.

Handling Mixed Carts

What happens when customers have both firearms and non-FFL items (like accessories) in their cart?