Skip to content

Creating Products

Learn how to add new products to your FirearmCart store

Updated View as Markdown

Add products to your store with pricing, images, and specifications.


Adding a New Product

  1. Navigate to Products
  2. Click Add New Product
  3. Enter the Product Name
  4. Click Create Product
  5. Fill in product details
  6. Click Save Product

New products are created as Draft so they are not visible on your store until you set them to Active.

The new-product form with title, description and pricing fields


Basic Information

Product Name

The product name displayed to customers.

Examples:

  • “Glock 19 Gen 5 9mm Pistol”
  • “Federal American Eagle 9mm 115gr FMJ - 50 Rounds”

Description

Enter a detailed product description. The description editor’s toolbar includes a Description Generator (sparkles) button: click it, optionally add instructions to guide the result, then click Generate.

Product Type

Choose the product type from the searchable Product Type dropdown. The list is a predefined taxonomy (for example Handguns, Rifles, Shotguns, Ammunition, Accessories) — you cannot type a free-form value.

Product type matters: it drives FFL compliance (whether the item must ship to a licensed dealer for transfer) as well as shipping compliance and carrier restrictions for handguns, long guns, and ammunition.


Pricing

Field Description
Price The selling price customers pay
Compare at price Original price shown crossed out (for sales)
Cost per item Your cost (not shown to customers)
Markup Your intended markup, as a percentage of cost
Profit Read-only — calculated from price and cost
Margin Read-only — calculated from price and cost

Profit and margin are recalculated automatically as you change the price or cost. Price and markup stay in step with each other: editing one updates the other.

For products sourced from a distributor, the cost field is read-only and shows the cost of the supplier row you’re viewing. When a product has several suppliers, the markup applies to its selected supplier’s cost, the supplier that fills its orders: see Pricing and Stock With Several Suppliers. An Auto-update price on cost change switch controls whether a sync recalculates the price from your markup when the supplier’s cost moves. Whether that recalculation follows the cost both ways, only raises the price, or never runs is your store’s Supplier Cost Changes policy under Fulfillment settings.

MAP Pricing

Distributors send a MAP (minimum advertised price) for products whose manufacturer sets one. How those products are priced is your store’s MAP pricing setting under Fulfillment settings:

Option Price of a product with a MAP
Never below MAP (default) Your markup over cost, with MAP as the floor: a price worked out from your markup never goes below MAP
Price at MAP Exactly the MAP. Your markup prices products without one, and any whose cost is at or above their MAP, so a product never sells at a loss

Either way, it applies when you import a product, change the Markup on the product page, use Reprice on the Products list, and when a distributor sync updates the price.

  • When a product has more than one distributor, the MAP that counts is the highest among the ones switched on, whichever supplier is selected. A distributor you switch off stops counting.
  • A MAP badge next to the price shows that MAP, and is highlighted when the product is priced at it. A price below it shows a Priced below MAP warning on the Pricing card. Under Price at MAP, a price above it shows Priced above MAP, because syncs move it back to the MAP.
  • When a price, even one you typed yourself, is below MAP, syncs reprice it from your markup over the supplier’s cost the way imports do, never below MAP. From then on it follows the supplier’s cost.
  • Syncs use the distributor’s current MAP, so a higher MAP raises the price too. Under Price at MAP, a lower MAP lowers it.
  • A product that’s out of stock with every supplier still shows its price, so syncs apply MAP to it too, at the cost it was last priced from.
  • None of this happens when the product’s Auto-update price on cost change switch is off, or under the Never change prices option for Supplier Cost Changes, because syncs don’t change those prices. Only raise prices never lowers a price, so under it a price above MAP stays there.
  • To find the products that have a MAP, filter the Products list by MAP. To find the ones priced below it, filter by Pricing > Priced below MAP.

SKU and Barcode

These fields live in the Inventory card.

Field Description
SKU (Stock Keeping Unit) Your internal product identifier
Barcode (ISBN, UPC, GTIN, etc.) UPC/EAN barcode

Both are searchable from the products list, and shoppers can find the product by either one in your storefront search.


Inventory

Track Inventory

Enable to track stock levels:

  1. Toggle Track inventory on
  2. Enter the current Stock on hand
  3. Optionally enable Continue selling when out of stock for backorders

Specifications

Specifications are name/value pairs such as Caliber: 9mm, Barrel Length: 4.02” or Capacity: 15+1. They appear in the specifications table on your product page, become the filters on your collection pages, help shoppers find the product in storefront search, and feed marketplace listings.

Adding a Specification

  1. Click + next to Specifications
  2. Choose a name from the Specification list, or pick Other to type your own
  3. Enter the Value
  4. Click Save

The specification is saved straight away, without Save Product. To change or remove one, open its menu and choose Edit or Delete. The Specifications card is only on the desktop product page.

Use a name from the list whenever one fits. Filters group products by the exact name, so “Barrel Length” and “barrel length” become two separate filters. Some features also look for a particular name: search reads Manufacturer and Brand, and checkout’s state restrictions read Magazine Capacity and Action Type.

Filters on Collection Pages

Your storefront builds the filters on collection pages and search results from specifications. Any specification with at least two different values among a page’s products can become a filter, and shoppers tick values to narrow the page. Choose which specifications appear as filters under Theme Settings > Collection Filters in the Visual Editor.

Calibers are merged: Caliber, Gauge and similar names make up one Caliber / Gauge filter, and common spellings such as 9mm and 9mm Luger count as one value. A gauge listed with a shell length, such as 12 Gauge 3”, counts as 12 Gauge. Chamber isn’t merged in, because it holds a shotgun’s chamber length, so it makes a filter of its own. See Filters on Collection Pages.

The In Store Specification

Add In Store with the value Yes to mark a product as stocked in your shop. It does two things:

  • Lists the product under the In Store filter on your collection pages
  • Lets the product be collected with local pickup

Choose In Store from the Specification list rather than typing it: a name like “In-Store” doesn’t count. Yes, Y, True and 1 all mean in store, in any capitals. Any other value, or no In Store specification, means not in store.

Copying a supplier’s specifications with Use this supplier’s content replaces the product’s whole list, In Store included, so add it again afterwards.

The Hazmat Specification

Powder, primers and percussion caps are hazardous materials: they ship by UPS or FedEx ground only, never USPS, only within the lower 48 states, and add your hazmat fee at checkout. Most of them are recognized automatically, from their product type or their distributor’s hazmat mark. The Hazmat specification lets you decide for a product yourself:

  • Yes makes the product hazmat, for powder or primers filed under another type
  • No takes the product off the hazmat rules, for an item such as a primer tool that was filed as primers

Choose Hazmat from the Specification list. Yes, Y, True and 1 mean hazmat; No, N, False and 0 mean not hazmat, in any capitals. While a product ships as hazmat, its Shipping card says Ships as hazmat. To set it on many products at once, use Mark as hazmat or Not hazmat on the Products list. See Powder and Primers (Hazmat).

The AI assistant and connected AI apps can mark a product as hazmat but can’t take a product off the hazmat rules; do that on the product page.

Other Ways to Add Specifications

  • Products imported from a distributor bring the distributor’s specifications with them
  • With the AmmoSeek plugin active, Generate missing specs looks up the specifications AmmoSeek needs, and you choose which to add
  • The AI assistant and connected AI apps can add and change specifications for you

Shipping

Weight and Dimensions

Enter product weight and dimensions for shipping calculations:

Field Options
Weight lb, kg, oz, g
Dimensions in, cm, mm

A product sold only from a distributor’s stock shows the distributor’s dimensions, read-only. Its weight is copied from the distributor when you import it, and distributor syncs never change it afterwards, so you can correct it here and it stays.

Products Missing a Weight

Checkout can’t price shipping correctly for a product without a weight. To list those products, click Filters on the Products page and set Weight to Missing weight. A product with variants is listed when any of its variants would ship without a weight. Products that don’t ship, such as event tickets and products that aren’t physical, are left out.

The AI assistant and connected AI apps can find these products too, and set the weights you give them, on distributor products as well as your own.

Physical Product

Toggle This is a physical product for items that require shipping.

Hazmat Products

When a product ships as hazmat, the Shipping card shows Ships as hazmat: it goes by ground only, never USPS, and adds your hazmat fee. See The Hazmat Specification.


Tax Code

The Tax Information card only appears when your team has an active tax plugin.

  1. Find the Tax Code field
  2. With Avalara or TaxJar active, choose from the searchable list of tax codes pulled from the provider (use the refresh button to re-fetch them). With any other tax provider, type the code into the field
  3. Save

Collection

Assign the product to a collection:

  1. Find the Collection dropdown
  2. Select a collection
  3. Save

Products can belong to one collection. Clear the dropdown to remove the product from its collection.


Product Status

Status Description
Active Visible and purchasable on your store
Draft Hidden from customers

Pick the status from the dropdown in the Product Status card, then save.


Changing Many Products at Once

On the Products list, tick the products you want to change. To cover every product that matches your search and filters, tick the box at the top of the list, then choose Select all … matching products in the bar at the bottom of the page. That bar holds the actions:

  • Status: Publish or Unpublish
  • Move to collection and Reprice
  • More: Set preferred supplier, Lock suppliers and Unlock suppliers under Suppliers, Merge (same UPC), Mark as hazmat and Not hazmat under Products, and Delete products

On a smaller screen they’re all in the bar’s Actions menu. Clear drops the selection.

Mark as hazmat and Not hazmat set each product’s Hazmat specification to Yes or No and keep its other specifications.

Publish, Unpublish, Move to collection, Lock suppliers, Unlock suppliers and Delete products change up to 1,000 products right away, and a bigger selection runs in the background. Reprice, Set preferred supplier, Auto-sort by product type (in Move to collection), Mark as hazmat and Not hazmat always run in the background, whatever the size of the selection. While one runs:

  • A banner at the top of the list shows how far it has got
  • You can keep working or leave the page while it runs
  • If you’re still on the list, a message confirms when it’s done. It also says how many products were skipped, such as products without a supplier from the distributor you chose with Set preferred supplier
  • Your store runs one of these at a time, so wait for it to finish before starting another

Importing Products from a CSV File

  1. On the Products list, click Import CSV
  2. Click Download Template and fill in one product per row
  3. Upload the file (CSV, up to 10MB) and click Import

Only name and price are required. Leave status blank to import a product as a Draft, or set it to active. A row whose SKU is already in your store is skipped, so you can fix any failed rows and upload the same file again.

Up to 50 products with no more than 10 images between them import right away, and the window lists any rows that failed. A bigger file imports in the background: a banner at the top of the Products list shows its progress, and you get an email when it finishes.

Adding Product Images to a CSV Import

Put each product’s image links in the image_urls column, separated by commas. The first link becomes the product’s main image. FirearmCart copies every image to your store, so your photos stay put after your old site closes.

  • Each link must be a full web address that opens the image itself, starting with https:// or http://
  • JPG, PNG, GIF and still WebP images up to 10MB each are copied
  • A link that opens a page, needs a login, or points to another file type is skipped, and the product imports without that image

A row whose SKU is already in your store is skipped, so a second import can’t add images to products you’ve already imported. Add those images on each product’s page instead.

Importing a WooCommerce Export

Moving from WooCommerce? Upload its product export as it is, and FirearmCart maps it for you.

  1. In WordPress, go to Products > All Products and click Export
  2. Keep the default options (all columns, all product types, all categories) and click Generate CSV
  3. Upload the file with Import CSV on the Products list
In WooCommerce In FirearmCart
Variable product and its variations One product with options and variants. Each variation becomes a variant with its own price, SKU, stock, weight and image
Attributes Specifications, except the attributes a product’s variations choose between, which become its options
Brands A Brand specification
Images Every image is copied to your store. The first is the main image, and a variation’s image shows when that variant is chosen
Regular price and Sale price The price. While a sale is on, the sale price, with the regular price shown struck through
Stock Tracked when WooCommerce managed the stock. Otherwise In stock sells without tracking, Out of stock imports with 0 in stock, and On backorder keeps selling at 0
Weight and dimensions Kept in the export’s units, such as lbs, kg, in or cm
GTIN, UPC, EAN, or ISBN Barcode
Sold individually Max quantity per order of 1
Categories The product type and collection

Every product imports as a Draft, whatever its status was in WooCommerce. Check each one’s product type before you publish it, because the type decides its FFL rules and shipping. When they’re ready, select them on the Products list and choose Status > Publish.

These aren’t imported:

  • Grouped products, which have no price of their own. The products in the group are imported from their own rows
  • Variations whose parent product isn’t in the file, and variations with no price, which WooCommerce doesn’t sell
  • Tags, reviews, upsells and cross-sells, tax classes and shipping classes

Images placed inside a description’s text aren’t copied. They still load from your WooCommerce site, so replace them before you take that site down.


Fulfillment

There is no fulfillment-type picker on the product form. Fulfillment sources are managed in the Supplier / Suppliers card, which appears once the product has at least one supplier source — for example after it is imported from a connected distributor.

  • A product you create by hand has no Suppliers card. Its stock lives in the Inventory card and you pick and ship the orders yourself
  • A product imported from a connected distributor carries that distributor as a supplier row, and its pricing, inventory, and shipping fields are read-only because they sync from the distributor. Printify imports also create size/color variants from the shop listing — see Printify
  • Once a Suppliers card exists, the Internal button on it adds your own stock as an extra fulfillment source
  • A product can carry several suppliers at once (see Inventory). A Selected badge marks the supplier it sells from right now, picked by your store’s Supplier selection. Choose Set as preferred from a row’s ⋮ menu to mark a supplier preferred: under Preferred supplier, it’s selected while it has stock
  • Click a supplier row to view its SKU, cost, and stock in the Pricing, Inventory, and Shipping cards

The Lock suppliers switch in the Product Status card excludes the product from automatic UPC merging during distributor imports. Imports never merge into a product with no distributor on it, such as one you create by hand, so for imports the switch matters once a product carries a distributor.


Navigation

Type to search…

↑↓ navigate↵ selectEsc close