boxcart.dev

Products

Create and manage your product catalogue with categories, quantity types, stock tracking, and flexible display options for card and table views.

Adding Products

Add your first products A name, description, photo, price and category, then a second product in a new category, sold by the punnet. Watch on YouTube

Products are managed through the BoxCart → Products admin screen. Each product is stored as a custom post type (boxcart_product) with dedicated meta fields for pricing, stock, and display settings.

  1. Navigate to the products screen

    In your WordPress admin, go to BoxCart → Products and click the Add Product button.

  2. Enter the product details

    Fill in the following fields:

    • Product Name: The title displayed to customers
    • Price: The base price for the product
    • SKU: An optional stock-keeping unit code for internal reference
    • Featured Image: Upload or select an image from the media library
    • Category: Assign the product to one or more categories
    • Also found by (1.8.0): Words or phrases customers might search for that aren't in the name, one per line, such as "bread" and "loaf" on a sourdough. Customers don't see them. See Search
  3. Configure stock and quantity options

    Set the stock status (in stock or out of stock), stock quantity, and optionally assign quantity type presets such as "per kg" or "per bunch". See the Quantity Types section below for details.

  4. Publish the product

    Toggle the product to Active and save. The product will now appear on your storefront in both card and table views.

BoxCart product editor showing the name, price, SKU, image, and category fields
Tip

You can duplicate an existing product from the product list to quickly create similar items. Use the duplicate action to copy the product name, price, category, and quantity type settings.

Product Categories

Organise your shop with categories The filter buttons customers see, adding a category, one product in two categories, changing the order, and deleting one. Watch on YouTube

Products are organised using the boxcart_product_category custom taxonomy. Categories are hierarchical, so you can create parent and child categories to build a structured catalogue.

Manage categories from BoxCart → Categories, where you can:

The sort order you set here determines the order categories appear in the filter dropdown and pill buttons on the storefront.

Category management screen with drag-to-reorder and inline editing
Info

Categories can also be imported and exported via CSV from the Import / Export screen.

Quantity Types

Sell by weight, each or by the pack The unit, price, step and limits of a quantity type, then a second way to buy carrots, by the bunch, and the tabs customers see. Watch on YouTube

Quantity types let you sell products in different units of measurement. Each product can have one or more quantity type presets. For example, a product might be available "per kg", "per bunch", or "each", each with its own price and increment rules.

When a product has multiple quantity types, customers see a tab bar on the product card or a dropdown in table view, allowing them to choose how they want to purchase the item.

Customers can type a decimal quantity with a comma or a point (1,5 or 1.5), and the quantity buttons show steps such as 0.25 exactly (0.25, 0.5, 0.75).

Each quantity type is defined by the following parameters:

ParameterTypeDescription
unit_label varchar(50) The singular unit name displayed to customers (e.g. "kg", "bunch", "punnet").
unit_label_plural varchar(50) The plural form of the unit name (e.g. "kgs", "bunches", "punnets"). Used when quantity is greater than one.
display_label varchar(20) A short label shown on the quantity type tab or button (e.g. "Per Kg", "Each").
price_prefix varchar(20) Text shown before the price (e.g. "per"). Defaults to "per".
price_per_unit decimal(10,2) The price charged for one unit of this quantity type.
allow_decimals boolean Whether the customer can enter decimal quantities. Enable this for weight-based units like kilograms.
step_increment decimal(10,3) The increment for the +/- buttons (e.g. 0.1 for 100g steps, 1 for whole units). Defaults to 1.
min_quantity decimal(10,3) The minimum quantity a customer can add. Defaults to 1.
max_quantity decimal(10,3) The maximum quantity a customer can add. Leave empty for no upper limit.
Product with multiple quantity types showing per-kg and per-bunch tabs on a product card
Tip

For a product sold by weight, set allow_decimals to true, step_increment to 0.1, and min_quantity to 0.1. This lets customers order in 100g increments with a minimum of 100g.

Card View and Table View

Show products as cards or a table The two views and the switch buttons, choosing which views your shop offers and which one customers see first, and the layout settings for each. Table view comes with BoxCart Pro. Watch on YouTube

BoxCart offers two display modes for your product catalogue, and customers can switch between them using a toggle button on the storefront.

Card View

Card view displays products in a responsive grid layout. Each product is shown as a card with its image, name, price, quantity selector, and add-to-basket button.

The ⓘ next to a product's name opens its info pop-up, with the description. Since 1.8.0 customers can also tap a product's photo to open the pop-up with the photo shown large, which helps most on phones. The large photo only downloads when they tap it. It's on by default; switch it off with Tap a product photo to see it larger under BoxCart → Settings → Styling → Product Display. In the table view (Pro), the thumbnail and the product name open the same pop-up.

SettingKeyDefaultDescription
Products Per Row (Desktop) products_per_row 3 Number of columns in the grid on desktop (1–4).
Products Per Row (Mobile) products_per_row_mobile 2 Number of columns on mobile devices (1–2).
Products Per Page products_per_page 12 Products shown before "Load More" pagination (1–500).
Card Style card_style shadow Visual style of product cards: shadow, border, or minimal.

Table View Pro

Table view presents products in a compact, spreadsheet-style layout that is ideal for stores with many items. On mobile, table rows are automatically converted to stacked cards for readability.

SettingKeyDefaultDescription
Products to Display table_products_limit 50 Number of products shown at a time, with a Load More button for the rest. -1 shows every product at once, which is slow with large catalogues.
Default View default_product_view cards Which view loads first: cards or table.
Show Image Column table_show_image true Display product thumbnail in the table.
Show Price Column table_show_price true Display the product price in the table.
Striped Rows table_striped_rows true Alternate row background colours for readability.
Unit Selector Style table_unit_style buttons How quantity types are presented in table rows: buttons or dropdown.
Products displayed in card view (left) and table view (right)
Info

You can enable or disable each view independently using the enable_card_view and enable_table_view settings. If only one view is enabled, the toggle button is hidden automatically.

Stock Management

Mark products sold out Marking a product out of stock, how it looks in your shop, the Hide out of stock box for customers, and putting it back in stock. Watch on YouTube

BoxCart provides simple stock management to track product availability. Stock settings are configured globally in BoxCart → Settings → General and applied per product.

Stock Status

Each product has a stock status that can be set to one of two values:

Global Stock Settings

SettingKeyDefaultDescription
Stock Management stock_management simple Options: simple (in stock / out of stock) or none (disabled). With none, every product can be bought, including any marked out of stock before, and Hide Out of Stock Products has no effect.
Hide Out of Stock Products hide_out_of_stock false When enabled, out-of-stock products are completely hidden from the storefront rather than shown with a badge.
Let customers hide out of stock products stock_toggle_enabled false Since 1.7.0: adds a "Hide out of stock" tick box above the products (on its own row on phones), so each customer chooses whether to see out-of-stock products. The choice is remembered on their device (cookie boxcart_hide_oos) and applied on the server, so Load More, categories, search and the Pro table view all respect it. Not shown when Hide Out of Stock Products is on for everyone.

Favourites Pro

Logged-in customers can mark products as favourites by clicking the heart icon on any product card or table row. Favourite products are stored in the customer's WordPress user meta as a serialised array of product IDs.

Favourites provide the following functionality:

Info

The favourites feature is only available to logged-in customers. Non-logged-in visitors will not see the heart icon on product cards.

Category Filtering and Search

BoxCart includes three tools to help customers find products quickly on the storefront. Each can be independently enabled or disabled in BoxCart → Settings → Styling → Product Display.

FeatureSetting KeyDefaultDescription
Category Filter Dropdown show_category_filter true A dropdown menu above the product grid that lets customers filter by a single category.
Category Pills show_category_pills true Clickable pill-style buttons for each category, displayed below the filter bar. Customers can quickly tap a category to filter the list.
Search Box show_search true A search box that finds products as the customer types: by name, by the product's Also found by words, by description and by category, with plurals and small typos handled. See Search.

All three filtering tools work together. For example, a customer can select a category from the dropdown or pills, then further narrow results by typing in the search box.

To see what customers search for, and which searches find nothing, turn on Search Insights (free, off by default).

Products Shortcode

The [boxcart_products] shortcode renders the full product catalogue on any WordPress page. It supports both card view and table view, along with filtering, search, and pagination.

[boxcart_products]

Shortcode Attributes

AttributeTypeDefaultDescription
category string (slug) '' Filter products by category slug. Leave empty to show all categories.
limit int From settings Number of products per page before pagination. Inherits from the products_per_page setting.
columns int (1–4) From settings Number of product columns on desktop in card view. Inherits from the products_per_row setting.
show_filter 'yes' / 'no' From settings Show or hide the category filter dropdown. Inherits from the show_category_filter setting.
show_search 'yes' / 'no' From settings Show or hide the product search box. Inherits from the show_search setting.
show_pills 'yes' / 'no' From settings Show or hide the category pill buttons. Inherits from the show_category_pills setting.
pagination string 'load_more' Pagination style: load_more, numbered, or none.

Examples

Display only products from the "vegetables" category with 4 columns:

shortcode
[boxcart_products category="vegetables" columns="4"]

Show 24 products per page with numbered pagination and no search box:

shortcode
[boxcart_products limit="24" pagination="numbered" show_search="no"]

A minimal products grid with no filtering or search controls:

shortcode
[boxcart_products show_filter="no" show_search="no" show_pills="no"]