boxcart.dev

Getting Started

Install BoxCart, then let Guided Setup take you through your shop pages, collection times, first product and payments. Most shops are ready for a test order in about five minutes.

Requirements

RequirementMinimum Version
WordPress6.0 or higher
PHP7.4 or higher
MySQL / MariaDB5.7+ / 10.3+

Installation

  1. Upload the plugin

    In your WordPress admin, go to Plugins → Add New → Upload Plugin. Select the boxcart.zip file and click Install Now.

  2. Activate

    Click Activate Plugin. BoxCart creates its database tables and registers its post types, then opens Guided Setup. If your shop is already set up (for example, you're reactivating BoxCart), you go to the BoxCart dashboard instead.

  3. Find BoxCart in the admin menu

    A new BoxCart menu appears in the WordPress admin sidebar. Guided Setup lives at BoxCart → Setup, and on a new shop the dashboard's Start Guided Setup button takes you there too.

BoxCart menu in the WordPress admin sidebar after activation

Guided Setup

Install BoxCart and run Guided Setup From Plugins › Add Plugin to a shop ready for its first order: pages, collection times, a first product and payments. Watch on YouTube

Guided Setup (BoxCart → Setup) gets your shop ready in five steps. Each step saves on its own, so you can stop part way and come back: the page opens at the first step still to do. Every step has a Skip for now button, and everything you choose can be changed later.

  1. Your shop pages

    Click Create my pages. BoxCart makes whichever of the Shop, Basket, Checkout and My Account pages you don't have yet, adds the right BoxCart block to each, and assigns them in Settings → General → Page Setup. If you've already made a page with the BoxCart shortcode or block on it, BoxCart reuses it instead of making a duplicate.

    Want to use your own pages? The step's Prefer to use your own pages? section lists the shortcodes to copy (see Setting Up by Hand).

  2. Collection

    Tell BoxCart where and when customers collect:

    • Name of the collection point (required), plus an optional address, town and postcode
    • Which days can customers collect? Click a day to switch it on or off. Open days show a tick; Monday to Friday are on to start with.
    • Collection times: the time slots customers choose from, each with a start time, an end time and how many orders it can take, set out as on the Time Slots screen. Two slots to start with (09:00–12:00 and 12:00–17:00, 10 orders each). Use Add a time slot for more, or the cross to remove one.

    A line under the form sums it up, such as "Customers will choose from 2 time slots on Mon, Tue, Wed, Thu and Fri". Click Save and continue and BoxCart creates the location, opens the days you chose, and gives each of them those time slots. You can give each day its own slots afterwards under Pickup Location (Locations on Pro). If you already have a location, this step shows it instead.

    Guided Setup collection step: the collection point's name and address, ticked open days Tuesday to Saturday, two time slots with orders per slot, and a summary of the times customers will choose from
  3. Your first product

    Add one product to start: a photo (optional), its name, its price, how it's sold, and a category (optional; a new one is created if it doesn't exist yet). Sold offers the same choices as the product editor: each, per unit, bunch, bag or box, or by the kg, gram or lb. For weights, choose the steps customers buy in (for example half a kilo, or 250 g). The price is only asked for when prices are switched on. Add the rest, with descriptions and more than one way of selling a product, from Products.

    Guided Setup first product step: new potatoes at £1.60, sold by the kg in steps of half a kilo, in the Vegetables category
  4. Finishing touches
    • How can customers pay? When they collect (cash or card in person) and/or Bank transfer, with the account name, sort code and account number customers pay into. Choose at least one. On BoxCart Pro there's also a link to connect Stripe for card payments in Settings → Payments.
    • Order emails: the name and address your emails come from, and where new order alerts go. These start as your site name and admin email address.
    • VAT: I don't charge VAT, My prices include VAT, or VAT is added on top of my prices, with the VAT rate (20% to start with).

    The payment and VAT questions only appear when prices are switched on.

    Guided Setup finishing touches step: how customers pay, who order emails come from, and whether prices include VAT
  5. Ready to go

    A summary shows which steps are done, with a Finish this link for any you skipped. Your shop can't take orders until it has its pages, a collection point and a product. Use Open my shop to see your shop as customers will, then place a test order.

    Make it your own links to the settings Guided Setup leaves alone: colours, fonts and buttons; when orders close; each day's collection times; the order emails; and customer accounts. Each step also ends with a line saying where its settings live afterwards.

    Guided Setup ready step: every step ticked, a suggestion to try a test order, and Make it your own links to the rest of BoxCart's settings
Tip

Once you've started, and until setup is finished, the BoxCart dashboard shows a Quick Start checklist (which you can dismiss) with a Continue Guided Setup button. Once you're set up, you can take Setup out of the menu with Hide Setup Page (see Misc Settings).

Setting Up by Hand

Each part of Guided Setup has its own screen, for when you'd rather set things up yourself or want to add more later. Each step links to its detailed documentation page.

  1. Create your pages

    BoxCart needs three required WordPress pages - Products, Basket, and Checkout - plus an optional Account page if you want returning customers to be able to sign in. Create the pages and add the corresponding BoxCart shortcode or Gutenberg block to each:

    • Products page: Add [boxcart_products] or the BoxCart Products block
    • Basket page: Add [boxcart_basket] or the BoxCart Basket block
    • Checkout page: Add [boxcart_checkout] or the BoxCart Checkout block
    • Account page (optional): Add [boxcart_account] or the BoxCart Account block. Skip this if you only want guest checkout - BoxCart works fully without it.

    Then go to BoxCart → Settings → General and assign each page in the Page Setup section.

    BoxCart page setup settings panel showing Products, Basket, Checkout, and Account page assignments
  2. Add a collection location

    Go to BoxCart → Locations (on Pro, click Add Location). Enter the location name, address, and contact details. Then choose its Open Days and add Time Slots: set up one day, then use Copy to other days to give the rest the same slots. See the Locations & Collection guide for full details.

  3. Add your products

    Go to BoxCart → Products and click Add Product. Enter a product name, price, optional SKU, and upload a featured image. Organise products into categories. See the Products guide for details on quantity types, stock management, and more.

  4. Configure payments

    Navigate to BoxCart → Settings → Payments. Enable at least one payment method:

    • Cash on Collection - No setup required, just enable it
    • Bank Transfer - Enter your account details
    • Stripe (Pro) - Card payments require BoxCart Pro. Enter your API keys (test mode recommended initially). See Free vs Pro.

    If payments are switched on but customers have no way to pay (for example, card payments are on without Stripe keys for the current mode), BoxCart shows a warning at the top of its admin screens, and checkout won't take orders until it's fixed. See the Payments guide for detailed Stripe setup instructions.

Place a Test Order

Place a test order and watch it arrive Order as a customer, find the order in BoxCart › Orders, check the emails, then cancel and delete it. Watch on YouTube

Visit your Products page on the frontend, add items to the basket, go through checkout and choose to pay when you collect. Check that:

Then tidy up: open the order under BoxCart → Orders, change its status to Cancelled, and click Delete order under Update Status. Only cancelled orders can be deleted, and deleting can't be undone (see Deleting Orders).

Tip

Stripe card payments require BoxCart Pro. If you're on Pro and using Stripe, start in test mode and use Stripe's test card numbers to verify everything works before switching to live keys.

General Settings

The General tab in BoxCart → Settings contains your core business configuration:

SettingDescription
CurrencySymbol (e.g. £), position (before/after), and decimal places
TaxEnable/disable tax, set the rate, choose whether your prices include tax or have it added on top, and customise the label (e.g. VAT, GST). With Show tax breakdown on (the default), receipts show tax added on top as its own line, or "Includes VAT" under the total when prices include it. The optional price suffix reads "inc. VAT" or "+ VAT" to match, unless you set your own text.
DatesSince 1.8.0: Write dates as "3rd November" adds st, nd, rd or th to the day wherever BoxCart shows a date: emails, the checkout, customer accounts, pick lists, reports and your admin screens. It's off to start with, so dates read "3 November" until you turn it on. The endings are English, so it only changes dates when the site (or your admin screens) are in English. The big day numbers on the checkout's date buttons stay plain, like a calendar.
ProductsSKU codes on or off, customer favourites (Pro), and Search Insights (since 1.8.0, off by default), which shows what customers search for and which searches find nothing. See Search Insights.
Stock ManagementSimple (in stock / out of stock) or disabled. Optionally hide out-of-stock products entirely, or let each customer hide them with a tick box. With stock management off, every product can be bought, including any marked out of stock before
Terms & ConditionsSelect a page - customers must accept before placing an order

Misc Settings

Housekeeping options live in BoxCart → Settings → Misc:

SettingDescription
Export / Import Settings (Tools)Download your settings as a JSON file, or restore them from one. Payment provider keys are never exported, and an import keeps the ones you have. Imported values are held to the same limits as the Settings screen, and a tax rate keeps its decimals (17.5 stays 17.5).
Hide Setup Page (Advanced)Takes Setup out of the BoxCart menu once you've finished. Switch it off to bring it back.
Debug Mode (Advanced)Logs BoxCart's messages, such as card payment errors, to help track down problems. They go to the WordPress debug log when that's on, otherwise to your server's PHP error log.
Delete Data on Uninstall (Advanced)Removes all BoxCart data when the plugin is deleted. Data is always kept on deactivation.
Saving settings

Saving a settings tab only changes the settings shown on it. Settings whose panels aren't on screen, such as Pro settings on the Free plugin or while a Pro licence isn't active, keep their saved values.

Adding the Mini Basket

Add BoxCart to your site, with a mini basket Your shop pages, Page Setup, the shortcodes, and a mini basket in your header so customers can open their basket from any page. Watch on YouTube

The mini basket is a compact basket button that you can place in your site header or navigation. Clicking it opens the sidecart panel.

Add the mini basket using the shortcode:

[boxcart_mini_basket]

Or use the BoxCart Mini Basket Gutenberg block in the block editor.

The mini basket supports three display styles via the style attribute:

Mini basket button in a site header showing the cart icon and item count

Next Steps

Rather we set it all up for you? Click & Collect Websites is our done-for-you service: we build, host and look after your ordering shop.