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
| Requirement | Minimum Version |
|---|---|
| WordPress | 6.0 or higher |
| PHP | 7.4 or higher |
| MySQL / MariaDB | 5.7+ / 10.3+ |
Installation
-
Upload the plugin
In your WordPress admin, go to Plugins → Add New → Upload Plugin. Select the
boxcart.zipfile and click Install Now. -
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.
-
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.
Guided Setup
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.
-
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).
-
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.
-
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.
-
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.
-
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.
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.
-
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.
- Products page: Add
-
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.
-
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.
-
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
Visit your Products page on the frontend, add items to the basket, go through checkout and choose to pay when you collect. Check that:
- Products display correctly in card or table view
- The basket updates as you add items
- Collection slot selection works
- The order appears in BoxCart → Orders
- Confirmation and admin notification emails are sent
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).
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:
| Setting | Description |
|---|---|
| Currency | Symbol (e.g. £), position (before/after), and decimal places |
| Tax | Enable/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. |
| Dates | Since 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. |
| Products | SKU 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 Management | Simple (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 & Conditions | Select a page - customers must accept before placing an order |
Misc Settings
Housekeeping options live in BoxCart → Settings → Misc:
| Setting | Description |
|---|---|
| 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 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
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:
icon-count- Cart icon with item count badge (default)icon-text- Cart icon with total pricetext-only- Text-only display
Next Steps
- Products - Categories, quantity types, stock management
- Locations & Collection - Multi-location setup, time slots, copying slots between days, closures
- Payments - Stripe setup, webhooks, troubleshooting
- Styling & Customisation - Colours, fonts, layout options
- Emails - Customise email templates and branding
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.