Products and stock

There are two ways to add a product and you can mix them freely. The right one depends on whether you care about seeing sales broken down by product inside Stripe.

Everything here happens on Products, under Bang! Cart in the WordPress sidebar.

The two kinds of product

Where you add itWhat you get
In Stripe, then Sync Best for tracking. Create the product in Stripe, press Sync from Stripe, and every sale counts against that product in Stripe's own reports. Name, description and photo come from Stripe and refresh on each Sync.
Here, in the plugin Quickest. Add it on the Products page and start selling. Only a product made here can have bold, italic, links and lists in its description, and, with Bang! Cart Pro, sizes and colours, a price the customer chooses, or a question for the customer. Stripe still takes the payment, but it sees a one-off line rather than a catalogue product, so it cannot group sales by product.

The price shown on this tab is what customers are charged, in both cases, so your sales and discount codes apply to either kind.

The Products page opens with the same choice side by side, under Which way should you add a product? Click its heading to fold it to one line; it stays folded for you (each admin's choice is their own) until you click it open again. On a new shop it starts open.

The Products page: a synced Stripe product with its name, price and stock fields, and Copy button shortcode and Copy price shortcode buttons
Every product carries its two copy buttons: one for its buy button, one for its live price.

Syncing from Stripe

Sync from Stripe reads your active products and their default prices. It pages through them, up to 1,000 products, so a large catalogue does not quietly stop at the first hundred.

Four things cause a Stripe product to be skipped: it has no default price, its price is not a simple amount (zero, tiered and metered prices all count), its currency is different from your shop currency, or it is a recurring subscription price. This plugin does not do subscriptions.

Sync tells you which. If some products come in and others do not, the success message ends with a line such as 1 skipped: 1 is priced in USD (your shop uses GBP). If none can be used, the message counts each reason, for example Found 4 products in Stripe, but none could be added: 2 have no default price, 1 is a subscription. If Stripe sends back nothing at all, the message says so, which nearly always means the key on the Stripe tab comes from a different sandbox, or a different account, from the products.

A synced product sells at one fixed price: its default price in Stripe. If the Stripe product has other prices as well, they are not brought in. A product that needs several prices, or any of Pro's per-product options, is added here in the plugin instead.

Products you added in the plugin are kept when you Sync. Only the Stripe half of the list is rebuilt.

Deleting a synced product here does not delete it in Stripe. Removing it takes out this plugin's local row only, and the next Sync brings it straight back, at Stripe's price and with its stock settings reset. To remove it properly, archive it in your Stripe dashboard.

Getting a product onto a page

Each product has a Copy shortcode menu in its header. Every choice in it has a small picture and a line saying what it gives you.

  • Add to basket button gives you [bangcart_button id="..."]. Paste it into the page where you want that product bought.
  • Price on its own gives you [bangcart_price id="..."]. Paste it where you want the price shown, so the page reads its figure from this tab rather than from a number you typed once and will forget to update. It is left out for a product where the customer types the amount, because there is no price to show.
  • Description on its own gives you [bangcart_description id="..."]. Paste it where you want the product's description, with its formatting, in your page's own font. Change the words here and the page follows.
  • With Bang! Cart Pro, Product card gives you the whole product - picture, name, price and button - as one card that fills its column, picture left, picture right or stacked. See The product grid and single product cards.

When a copy has worked, the Copy shortcode button turns green with a tick for a moment. All of them are covered in full in the Shortcode reference.

Asking the customer a question

Switch on Customer notes on a product and word the question yourself - "Name to engrave", "Which invoice is this for?", "Any allergies?" - and a box appears with the buy button. You can insist on an answer, in which case the product cannot be added to the basket without one.

Bang! Cart Pro. Asking for a note is a Pro feature, as are product variants - one product in several sizes and colours, each with its own price and stock. Both are set up on this tab, inside the product card you already know. Free keeps everything else here. See Order and product notes and What Bang! Cart Pro adds.

Updating from a version before 3.6.0? Check your stock figures once. A bug fixed in 3.6.0 could write a stock count against the wrong product: a product set to Unlimited stopped the browser sending its box at all, so every product below it took the count belonging to the one above, and the tab redrew showing the wrong figures as though you had typed them. Only shops with an unlimited product above a limited one were affected. The fix stops it happening again, but it cannot know what the numbers should have been - a count that has drifted needs typing in once.

Product type and extras

Under each product's details is a bar called Product type and extras. It holds everything that changes what kind of product it is or what comes with it: with Bang! Cart Pro, sizes and colours, a price the customer chooses, customer notes and digital downloads. It starts closed. While nothing in it is switched on, a grey line lists what is inside; once something is on, the bar shows a small chip for each one in use, so you can see at a glance which products are plain and which are not. Click the bar to open it.

Not on sale - and why

A product customers cannot buy shows a NOT ON SALE badge beside its name. Point at the badge and the reason appears, in plain words - for example Variants are switched on, but none has a price, or a download with no file chosen.

Open the card and the cause is marked where you fix it: its chip in the bar turns amber with a !, the bar reads Not on sale - see Variants (or whichever it is), and opening it shows the reason again at the top of that setting. Fix it and save, and all of it goes.

A product with the NOT ON SALE badge beside its name, and the Product type and extras bar open with the Variants setting marked in amber and the reason at its top
The badge marks it; inside the card, the setting that causes it says why.

The same reasons appear on Start here, each with a button that opens this page at that product with the setting already open.

Formatting a description

Above the description box on a product you added yourself are four small buttons. Select some words and press B for bold, I for italic, or the link button to turn them into a link (it asks for the address). The list button turns the lines you have selected into bullet points. Line breaks are kept as you type them.

That is all a description can carry, on purpose. Anything else - a script, a style, an image, a table - is removed when you save, so one product's description can never upset the rest of a page. If a product needs a fuller layout, build a page for it in your editor and put its [bangcart_price] and [bangcart_button] on it.

Stripe's checkout page cannot show formatting, so it gets the plain words: bold and italic disappear, a link keeps its text, and a list becomes items separated by dashes. A product synced from Stripe takes its description from Stripe, which is plain text; its line breaks are kept on your site.

On a site running WPML or Polylang, a product's name and description can be translated there, under Bang! Cart - see Other languages.

Duplicate

Products you added yourself carry a Duplicate button, beside the Copy shortcode menu. It clones the whole card, including price, stock, description and photo, gives it a fresh id ending -copy and a name beginning "Copy of", and opens it ready to edit.

It is the quickest way to build a family of related products in the free plugin: one recipe in three sizes is one product duplicated twice, rather than three products typed from scratch. Nothing is stored until you save, so a misclick is undone with Discard.

If you would rather sell that recipe as one product the customer picks a size from, that is Product variants, in Bang! Cart Pro.

Stock

Stripe has no inventory. Its catalogue covers pricing and billing, not what is on your shelf. So stock counts live in WordPress, keyed by product id, and they survive a re-sync from Stripe.

Each product is either Unlimited or Limited with a number. Unlimited products never show either stock message.

What the customer sees

  • At or below your low-stock threshold, a quiet line appears under the button reading Only 3 left.
  • At zero, the Add to basket button greys out, cannot be clicked, and reads whatever you set as the sold-out label.

What is already in the basket counts. With three in stock and three already in someone's basket, the button reads sold out for them. That is the correct behaviour, and it is worth knowing before you conclude the count is wrong.

The Stock messages card

At the foot of the Products page, not on Design or Settings. It has two controls:

SettingWhat it does
When stock reaches zero, the button saysThe sold-out button label. Defaults to "Sold out". Write your own if you would rather say "Back soon".
Warn when this many are leftThe low-stock threshold, 0 to 99, default 5. Set it to 0 to never show the warning.

The wording of the low-stock line itself is fixed at "Only 3 left". The threshold is yours; that sentence is not.

With Bang! Cart Pro, a sold-out product can also invite the customer to leave their email address and hear when it is back. See Back-in-stock emails.

Selling a file

With Bang! Cart Pro, any product - one of yours or one synced from Stripe - can be a file to download instead of something posted: a pattern, a recipe card, a print file. It asks for no postage, and each buyer gets their own private download link. See Digital downloads.

Two people, one last item

Stock is decremented when payment succeeds, in the webhook, never in the browser. That means an abandoned basket never eats stock.

It leaves one gap, which the plugin closes with a reservation. When a customer reaches checkout, the units they are buying are reserved behind a database lock before Stripe is contacted. A second customer trying for the last item in the same moment is told, plainly, "Sorry, someone just took the last of one of your items. Please lower the quantity and try again."

The reservation is released when payment lands. If the customer wanders off, it expires by itself after thirty minutes, so a flaky webhook can never strand your stock. A delayed bank payment holds its reservation for longer, because those take days to clear and the stock should not be sold twice in the meantime.

If stock never goes down, your webhook is not connected. Nothing else in the plugin decrements stock. See The webhook.

Still stuck?

Write to me and it is me who answers, not a ticket queue. Tell me what you expected and what happened instead.

Ask a question

Bang! Creative Family

Bang! Plugins is part of a small UK creative group, so the plugins are made and backed by people who do this for a living.