Skip to content

FFL Rules Configuration

Configure shipping restrictions and FFL transfer requirements

Updated View as Markdown

The FFL Rules settings page allows you to configure which products require FFL transfers and which states or product categories are restricted from shipping.

Accessing FFL Rules

Navigate to Settings > FFL Rules in your admin panel.

Configuration Sections

Excluded States

Block entire states from placing orders. Customers from these states will see an error message at checkout and will be unable to complete their purchase.

Use this feature for states where you choose not to ship any products due to:

  • Complex regulatory requirements
  • Shipping restrictions
  • Business decisions

No states are excluded by default.

Category Exclusions by State

Block specific product categories from being shipped to certain states. Unlike excluded states, customers from these states can still purchase other products.

Example use cases:

  • Block ammunition sales to California
  • Block high-capacity magazines to states with capacity limits
  • Block assault-style weapons to states with assault weapon bans

To add a state exclusion:

  1. Click “Add State”
  2. Select the state from the dropdown
  3. Choose which product categories cannot be shipped to that state
  4. Save your settings

No category exclusions are configured by default.

Always Require FFL Transfer

Configure which product categories always require an FFL transfer, regardless of the customer’s state. The seeded default covers:

  • Handguns, pistols and revolvers
  • Long guns, rifles and shotguns
  • The used equivalents of the above
  • Lower receivers and pistol frames
  • Upper receivers
  • Suppressors
  • NFA products

These products will require the customer to select an FFL dealer during checkout.

State-Specific FFL Rules

Configure FFL requirements that apply only to specific states. For each state, you can set:

Categories Requiring FFL Products in these categories will require an FFL transfer only when shipping to this specific state.

Magazine Capacity Limit The maximum magazine capacity allowed for products shipped to this state (1–100). Products with magazine capacities exceeding this limit will trigger restrictions at checkout.

FOID Requirement Check this if the state requires a Firearm Owner’s Identification card. The seeded defaults enable it for Illinois and Connecticut. When enabled for a state:

Customer Experience:

  • After completing checkout, customers shipping to FOID-required states will see an upload prompt on the order confirmation page
  • Customers can also upload their FOID card by visiting their order details page (linked in the order confirmation email)
  • The upload supports JPG, PNG, GIF, and PDF formats up to 10MB
  • Once uploaded, a green confirmation message replaces the upload prompt

Admin Experience:

  • On the Order Details page, you can see how many files the customer has uploaded
  • Click the files count to open a modal showing all customer files (FOID cards, licenses, etc.)
  • Click any file to preview it directly in the admin panel
  • Files are also visible on the Customer Details page

Note: FOID requirements only apply when the order is shipping to an FFL dealer. Orders without FFL transfers do not require FOID uploads.

Compliance Warnings

The system will display warnings if your FFL rules are less restrictive than the shipped defaults. Two things are checked:

  • Any category the defaults require an FFL for that you have removed from Always Require FFL
  • Any state magazine capacity limit you have set higher than the default for that state

While you can proceed with less restrictive rules, be aware of:

  • Federal regulations that apply regardless of your settings
  • State-specific laws that may require stricter compliance
  • Liability considerations for your business

Default Rules

Your FFL rules are pre-populated with the shipped defaults when your store is created. These defaults include:

  • Standard product categories requiring FFL (firearms, receivers, suppressors and NFA products)
  • State rules for CA, NY, NJ, MA, CT, HI, IL, CO, WA, MD, RI, VT, DE, DC and OR — magazine capacity limits, categories requiring an FFL in that state, and FOID requirements where applicable
  • Restricted action types for CA and NY

Once you save, your saved rules replace the defaults outright — categories you removed stay removed and are never silently re-added.

You can reset to these defaults at any time using the “Reset to Defaults” button. Resetting reloads the form; you still need to save to apply it.

How Rules Are Applied

When a customer checks out:

  1. FFL Requirement Check: As soon as a shipping state is known, every cart item is tested against your global and state-specific FFL rules. If any item requires an FFL, the FFL selection step is shown. This check also fires when a product’s magazine capacity exceeds the state limit, or its action type is restricted in that state.
  2. State Exclusion Check: When payment is submitted, if the shipping state is completely excluded, the whole cart is blocked with “We do not ship to {state}”
  3. Category Exclusion Check: Any cart item in an excluded category for that state is blocked
  4. Attribute Checks: Any item whose magazine capacity exceeds the state limit, or whose action type is restricted in that state, is blocked

Blocked items are listed back to the customer with the reason, and the order cannot be completed until they are removed.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close