Skip to content

BadgerCommerce Platform Features

Reference documentation for what the BadgerCommerce platform does today. Each page describes the behaviour in the code; anything not built yet is called out rather than described.

Core Platform Features

Product Catalog Management

A robust system for managing products, variants, collections, and inventory with advanced search and discovery capabilities.

Product Taxonomy

The tree of levels and typed attributes products are classified against: the editor in the admin, how inheritance, validation and revisions work, what activating a different taxonomy clears, and the impact checks before a change.

Order Management

Comprehensive order processing from cart creation through checkout, payment processing, and fulfillment.

Dispatch, Cancellations & Returns

Dispatch tracking in the customer's dispatch email, resending it, cancelling orders before dispatch (refund or release, restock, customer email), returns (RMAs) after dispatch, and what the pipelines do when an order is in the wrong state.

Product Reviews

Verified-buyer reviews: asked for by email after dispatch, extra ratings such as size and fit, photos, a cheap AI moderation check before anything is published, a staff queue, and the reviews block on the product page.

Shoppable Images

Pictures with your products in them (an outfit, a room, a recipe) with numbered hotspots and Add to basket for each product, on any page, collection, category or product page ("complete the look").

Image Focal Point

Mark the part of a photo to keep in view (a face) by clicking it in the media library, so carousels and hero backgrounds crop around it on every screen size instead of cutting heads off.

A built-in cookie banner that keeps Google Analytics and Hotjar off until visitors accept, asks again when the cookie policy changes, and logs every choice as evidence of consent.

Who has agreed to hear from your shop, with proof: the sign-up tab and registration with double opt-in, marketing and terms-of-sale consent at checkout, the account Preferences tab, unsubscribe and one-click links, contacts, lists and the subscriber export in the admin, stored contact-us enquiries, and the site upgrade that turns it on.

Email Campaigns

Campaigns to your mailing lists from your own verified sending domain, with one-click unsubscribe, a do-not-email list fed by bounces and spam reports, scheduling in your shop's time zone, and the numbers for each send.

Fulfilment

Per-line fulfilment state, automatic fulfilment of digital items, and fulfillers who each see only the lines they are responsible for.

Sell products printed only when ordered: a Prodigi fulfiller sends each order to Prodigi, takes dispatch and tracking back, cancels while Prodigi still allows it, and keeps cost prices in step, set up from the admin or by an AI agent through MCP.

Parcel Labels

Rate, buy, print and cancel carrier labels from the fulfilment portal and the POS app, book courier collections, and email customers prepaid return labels. Sandbox, ShipStation, Sendcloud and Royal Mail Click and Drop.

Delivery Promise

The date an order arrives, at checkout ("Arrives Tuesday 13 October"), on product pages and in the basket ("Order within 1 h 13 min for delivery tomorrow") and in the confirmation: worked out from each location's courier collection times and pick and pack time, the delivery option's transit days, UK bank holidays and the shop's own closed days.

Parcel Tracking

Follow labelled parcels to the door: provider webhooks and polling, one status vocabulary, a timeline on the customer's order page, optional delivery emails, delivery problems in the ops inbox, and orders moved to DELIVERED when everything has arrived.

Collection and Delivery Slots

Enterprise: a full or closed store is offered "Ready from Wednesday 15 October" instead of dropped, and locations can offer collection slots and own-van delivery windows to a postcode area, chosen at checkout, booked at payment and shown to staff in the portal and POS.

Locations

Stores, warehouses and distribution centres: one main location for every shop with no set-up, stock at several locations on Enterprise, and POS tills tied to the store they're in.

Click and Collect

Enterprise: customers collect an online order from any of your stores, against that store's own stock, with a "my store" choice and store stock on product pages and in the basket.

Partly Collected, Partly Delivered

Enterprise, off by default: one order, one payment, some items collected from a store and the rest delivered, chosen per item in the basket or at checkout, with each part picked, handed over, cancelled and returned on its own.

Marketplace Channels

Sell on eBay and Google Shopping from the same catalogue: readiness checks and AI-filled attributes, automatic publishing and stock, eBay orders imported into the fulfilment queue, dispatch and refunds sent back, and payouts reconciled against orders.

Pipeline Configuration

Site-level control of the processor chain behind order submission, packing and dispatch — reorder, enable and disable steps in admin.

Search and Discovery

Category pages from merchandising trees, filters chosen by the results (with price ranges and a More filters fold), category navigation with counts, search within a category, and the Typesense index behind them.

Search Architecture

Architectural principles, domain model, and indexing pipeline behind the search-first discovery platform — the merchandising tree, taxonomy projections, virtual categories, and how they all flow into Typesense.

Product Engagement

How each product does in each category and search: impressions and position, click-through, views, adds to basket, orders and revenue per listing slot, with "viewed but unbought" and "sells but unseen" lists. The measurement behind ranking by what sells (Enterprise).

Ranking by What Sells

On Enterprise shops with enough orders, Featured orders products of similar relevance by a nightly learned score for the listing's goal (units, conversion, revenue or margin per time shown), smoothed, decayed and with room for new products. Goals per shop, per category and on dated schedules, from the admin, REST and MCP.

Learned Boosts

Products doing clearly better in one category or search than its average are suggested for a boost there each night, and decided by a merchandiser, the shop's AI or autopilot, within guardrails: the merchandiser's own rules win, a few per listing, and they lapse unless they keep earning their place.

Search Experiments

Split visitors between two ways of ranking the Featured order and compare revenue per visitor, conversion and click-through, with 95% ranges, a plain-English verdict, an "early" notice until the planned sample is in and a sample-ratio check, from the admin, REST and MCP (Enterprise).

Cost Prices and Margin

What each product and variant costs, set in the admin, by CSV or through REST, for margin per product and listing and ranking for margin. Commercially sensitive: admin and finance roles only, and never in the storefront, the search index, site transfers, exports, logs or AI tools (Enterprise).

Search Rules: Pins, Redirects, Banners

Merchandiser control over listings and searches: pin, boost and bury products by SKU on a category and per search term, send a search term straight to a page, and show a banner above a term's results, from the admin, REST and MCP.

Search Synonyms

Per-site synonyms so "shoes" finds footwear: multi-way and one-way, AI suggestions from zero-result searches reviewed before they go live, an "explain a search" diagnostic, and management from the admin, REST and MCP.

Search Bar & Autocomplete

The placeable storefront search box with as-you-type product and category suggestions, jump-straight-to-product navigation, and an optional animated placeholder.

Optional per-site search over CMS pages and blog posts — a separate Typesense index fed from each page's extensions, surfaced in the search-box dropdown and as a Pages & articles tab on /search with snippets and tag filtering.

Finish Setting Up

The admin home page's to-do list of what the features a shop uses still need before they work (Stripe, the till and card readers, kitchens and delivery areas, dining rooms, central sign-in, business details), with badges on the Settings tiles and a setup section in the MCP ops inbox.

Platform Upgrades

The admin page where an existing shop switches on new features that need a one-off step: what needs attention, what to apply (compliance first), what's optional and for whom, and what's done, with progress and a "Not needed" choice.

Multi-Tenancy Architecture

True multi-tenant capabilities allowing multiple storefronts to operate from a single platform instance.

Demo Sites

Four fictional merchants on four themes (Pop, Depot, Brock, Nova), seeded with one command: the quickest way to see the platform's range.

Password-Protected Previews

Keep a site behind a password until launch, and share it with a link (or QR code) that carries the password and drops the visitor on the page, with a "preview" badge on every page.

Staff-Only Collections

Sell some products only to signed-in staff, such as team clothing, from the main shop: anyone without the Staff role sees no trace of them and can't buy them.

Site Data Transfer

Export and import site configuration and catalogue data between environments, with automatic ID remapping and PII exclusion.

Extension System

A flexible extension framework for customizing functionality and adding new features without core code changes.

AI Integration

The MCP server that lets AI agents run a shop, AI image tagging, the Design Brief chat, and the browser-side menu and JSON component generators.

Payment Processing

Secure, flexible payment handling with support for multiple payment methods and advanced features like saved payments, an email to the shop each time Stripe schedules a payout, showing what it's made of, and a Payouts page listing every payout and the orders in it.

Ways of Paying a Product Refuses

A product can refuse credit cards, particular card brands or methods such as Klarna (a lottery entry can't be bought on credit). The card is checked before any money is held and the shopper is asked to pay another way; a subscriber who later saves a refused card has their previous card put back.

VAT

For shops whose prices include VAT: the VAT in each order worked out at checkout for where it goes (UK and EU rates), shown to shoppers, on the order email as a VAT receipt, and totalled by country and rate for the VAT return.

Selling in Several Currencies

A shop that sells in pounds and dollars runs a site per currency and links them: a currency menu in every theme's header opens the same page on the other site, and search engines are told the sites are versions of each other.

Gift Cards

Complete gift card system with internal and external providers, PIN encryption, virtual gift card sales, and checkout redemption via PaymentV2.

Event Tickets

Sell a fixed number of tickets for an event, with a QR code per person, door check-in in the Badger app, and an attendance view with manual check-in, void and CSV export.

Restaurant Ordering

Takeaway collection and local delivery for restaurants: menu items with allergens and modifier groups, ordering hours per location, and a kitchen that accepts each order before the customer is charged. In development, off by default.

Table Reservations

Guests book a table on the restaurant's own site; staff run the evening from a diary of tables against time, with phone bookings, walk-ins, enquiries for big parties, a booking tester for the dining room's rules, and guest profiles with GDPR retention, forget and export. In development, off by default.

Appointments

Customers book a named practitioner or "Any available" for an appointment type (an NHS eye test, a contact lens fitting) on the shop's own site. Each practitioner has their own hours, breaks and leave; "Any available" is resolved by a pluggable strategy (spread evenly, or fill one practitioner first). The same engine, diary, emails and guest page as table bookings. Free or pay-in-store appointments first; online payment follows. In development, off by default.

Table Service

Servers run tables from the Badger app: tabs by seat and course, courses sent to the kitchen, voids and comps approved by a manager, bills split any way and paid at the table with tips. Admin keeps the tips records the Employment (Allocation of Tips) Act 2023 asks for: the tips report and CSV, a versioned tip policy, and workers' requests for their records. In development, off by default.

Product Type Decorators

Per-product input contracts (recipient email, donor name, gift card number) — how decorators are wired internally, the built-in catalogue, and the REST registry that lets headless clients discover and submit decorator inputs.

Customer Account

The shopper's account area: a header band with tabs, an overview of their orders, donations, fundraisers and subscriptions with their details and last address, and a tab for each.

Subscriptions

Recurring billing and subscription management powered by Stripe, with automated lifecycle handling via webhook events.

Content Management

Pages, content blocks, the media library, menus, blogs, stereotypes and breadcrumbs.

Block Drafts

Change a page's content blocks as a draft, preview it on the real shop, then publish it, with a warning if the live page changed meanwhile.

Change Requests

Admins send in news, events and people in their own words with photos; an AI writer turns each request into a draft page or blog post to preview, revise, approve or reject. Photos go into the media library, described as content by AI image tagging, and nothing is published until a person approves it.

Site Customization

Themes and theme layering, the Design Brief, custom CSS, site identity, Site Text, page layouts and error pages.

Marketing Tools

Promotions, SEO (meta tags, sitemap, redirects, robots.txt), email capture, social sharing and login, merchandising blocks and analytics.

SEO Structured Data

The site-wide schema.org WebSite and Organization JSON-LD in every storefront page's head, and the BlogPosting on blog posts: what goes in them, where each value comes from, when the search box is advertised, and the structured-data-enabled switch.

Catalogue SEO

Which category-page URLs are indexed: self canonicals for the clean category and its later pages, noindex, follow for filtered, sorted and searched variants, tracking parameters ignored, /search kept out of the index, category pages in the sitemap, and rule-generated brand and attribute landing pages (/c/{category}/brand/{brand}, /c/{category}/colour/{colour}) that are linked from their category, listed in the sitemap and edited in the admin, REST API or MCP; cross-domain canonicals are left out of the sitemap.

Transactional Email

The compact email rendering engine that runs on any node, and the RabbitMQ job queue that offloads order-pipeline email sending to the worker so request-handling nodes stay lightweight.

Central Sign-in

Signing in to shops through the shared auth server: central identities versus shop accounts, turning it on for a shop, how existing shop accounts move over the first time their owner signs in, and why every new identity confirms its email before it can be used.

Subscription Entitlements

Knowing which edition — Lite or Enterprise — each shop is subscribed to, driven by signed webhooks from Badger Sett: the capability vocabulary, how an organisation resolves to shops, where the feature gates sit, why a shop we have never heard of keeps everything, and the enforcement switch that ships disabled.

Platform Billing with Stripe

How shops pay Badger Commerce for their plan: Checkout at sign-up (a card always taken, the trial, founding prices, setup fees), upgrades and downgrades, add-ons and extra locations, VAT on Stripe's free tax rates, the billing webhook, pausing a shop that stops paying, the nightly reconcile, and the per-order application fee taken from the plan.

Plan Limits

What happens when a shop goes over its plan's limits: admin is never blocked, while the storefront holds back the newest products, extra locations, bookable people, online table bookings past the month's allowance, a custom domain and staff sign-ins; monthly active customers only ever warn. How usage is counted, who is enforced, the admin banner and the Slack alerts.

System › Billing

Where Badger staff manage what shops pay for the platform: MRR and trial conversion, every shop's subscription with plan assignment, one-off limit allowances, trials, pausing and cancelling, the plan and add-on catalogue with prices and founding offers, and the Billing card on each tenant.

Self-serve Sign-up and the Plan Catalogue

Signing up for a shop at /start: plan, web address, emailed code and a card for every trial, then the shop built from a template for its kind; the public plan catalogue (GET /v1/public/plans) and the pricingTable block that shows it.

Platform Architecture

BadgerCommerce is built on a modern, scalable architecture:

  • Spring Boot Framework: For robust, enterprise-grade backend services
  • MongoDB: Flexible, document-based data storage
  • Event-Driven Design: For scalable, resilient operations
  • API-First Approach: RESTful APIs for all core functionality
  • Responsive Front-End: Mobile-optimized customer experiences
  • Containerized Deployment: For easy scaling and management

Extending BadgerCommerce

The platform is designed for extensibility:

  • Custom Extensions: Build your own extensions using the extension framework
  • API Integration: Connect with external systems and services
  • Custom Themes: Create unique visual experiences; merchants choose between them in Choosing a Theme
  • Brock Theme: A conversion-focused storefront theme layered on Nova
  • Atelier Theme: An editorial, image-first storefront theme with oversized serif product names, an asymmetric grid and a filter drawer, layered on Nova
  • Depot Theme: A dense, catalogue-first storefront theme with a persistent filter rail and a quick-buy list view, layered on Nova
  • Pop Theme: A bold, colour-blocked storefront theme with a colour per product, layered on Nova
  • Spec Theme: A dark, product-as-hero storefront theme for premium tech and audio, with showcase rows and a colourway accent, layered on Nova
  • Ridge Theme: A theme for charities, rescue teams and clubs: a photo hero, blog posts as cards, a log or a timeline, and a donor thank-you wall, in two brand colours, layered on Nova
  • Bistro Theme: A menu-first theme for restaurants and takeaways: sticky menu sections, dietary filters, allergens on every dish, an item sheet for sizes and extras, and the order always in view, layered on Nova
  • Diorama Theme: A dark, photo-first theme for photo blogs, galleries, makers and clubs: full-screen photos under a see-through header, the blog as a photo wall with a full-screen viewer, and posts that open on their photo, layered on Nova
  • Tend Theme: A calm, warm theme for businesses customers book (salons, clinics, opticians, studios): a floating header with Book an appointment always in reach, a booking bar on phones, and the shop's services, prices and address above the footer on every page, layered on Brock
  • Basket and Checkout: A themeable basket and checkout: one card of lines, a sticky order summary, a pinned checkout bar on phones, and --nb-* tokens each theme re-skins it with
  • Direct Checkout Links: /buy/{product}?amount=2 links that go straight to checkout with one product, leaving the basket alone; for QR codes, emails and "donate now" buttons on other sites
  • Donation Display: recent donations and donors' messages of support on any page or fundraiser, as a static list or a pausable carousel
  • Business Logic Customization: Adapt the platform to your specific business requirements
  • Data Import/Export: Flexible data exchange with other systems

For detailed information on developing with BadgerCommerce, please refer to the Developer Guide.

Getting Started

To begin exploring BadgerCommerce, we recommend:

  1. Reading the Developer Guide for architecture and local setup
  2. Working through the Building Extensions guide
  3. Exploring the feature documentation in depth based on your priorities

Support and Community

BadgerCommerce is backed by a dedicated team and community:

  • Documentation: Comprehensive guides and references
  • Support: Enterprise support options available
  • Community Forums: Exchange ideas and get help from other users
  • Training: Formal training options for developers and merchants