![\"The](\"/news/kahunacart-1-6-0/free-themes.webp\")
\nI'm excited to announce KahunaCart 1.6.0! It's a big one, with 49 changes (21 new features, 17 improvements and 11 fixes), and 1.6.1 followed later the same day with one more. The changelog only tells half the story though, because most of my time on this release actually went into themes.
\nUp until now, if you wanted your store to look different, you had to copy KahunaCart's templates into your theme and edit them there. That's fine until the next release fixes something in checkout and your theme keeps serving its own old copy of the page. Our own Kahuna theme had twelve of these copied templates, and I was going through them by hand every time we released. I really didn't want everyone else who builds a theme to be stuck doing the same thing.
\nWith 1.6, every storefront page is split up into named blocks. That covers checkout, the cart, the product page, the order page, product listings, categories and search. Each region of a page gets its own block, and a layout block on each page arranges those regions into columns. Your theme's checkout template now just extends KahunaCart's and overrides the blocks you actually want to change. Everything else still comes from KahunaCart, so when we fix something in a later release, your store picks it up without you touching the theme.
\nThe little pieces that show up all over the store have moved into their own files too: the product card, the cart line, the receipt line and the delivery method. Change the product card once and every card in the store follows, even the ones the filters load in on the fly.
\nThemes also get some new settings (type, card shadows, the gap between cards, the focus ring, and the size card pictures get cropped to), plus a handful of helpers for things a theme used to have to figure out on its own:
\nIf you've already got a theme with copied templates, don't worry. It still works exactly like it did before.
\nIf you build themes, check out Theme blocks for the full list. There's a test in KahunaCart that checks that list against the actual templates, so it won't drift out of date.
\nOnce the blocks were in place, we built three themes on them, and all three are free with every KahunaCart license:
\n\nEach one has full light and dark designs, and they come with the extra pages a real shop needs: a home page, an about page, a journal and bookings. Install them from the admin with the license key you already have, or from the command line with bin/gpm install slate. You don't need to buy anything, and you can switch between them whenever you feel like it.
Here's the same product page in all three. Slate and Pebble don't copy a single KahunaCart template to get there, they just extend them. Pretty cool, right?
\n![\"The](\"/news/kahunacart-1-6-0/one-product-three-themes.webp\")
\nThe home and about pages in every theme are now built from modules. That's things like a hero, a row of categories, featured products, a band of text with a picture, and whatever else the theme offers. You add them in the admin, drag them into the order you want and switch them off when you don't need them, with picture and icon pickers where they make sense. No more editing a template just to move a section around.
\n![\"The](\"/news/kahunacart-1-6-0/home-modules.webp\")
\nThe module list in the page editor is new in Admin 2.1.40 and API 1.0.57, which went out this week as well. They also bring icon sets, so a theme can put its own icons in the icon picker.
\nBuilding the free themes on blocks went so smoothly that we just kept going, and ended up with six business themes. Each demo is set up as an example business with its own photography, fonts and colors, and a home page that puts its add-on to work right there on the page, so you can try it the way a visitor would.
\n![\"The](\"/news/kahunacart-1-6-0/business-themes.webp\")
\nThose businesses are only examples though, and nothing in a theme ties it to the one in its demo. Vellum would work just as well for a florist or a studio, and Encore suits anyone with records, merch and dates to sell. Swap in your own words, pictures and colors. Every demo has a color panel, so you can try a few out before you buy.
\nEach business theme is $99, a one-time purchase that goes onto your KahunaCart license key just like any other add-on, and updates are included with your site renewal. If you don't already have the add-ons a demo uses, there's a bundle for each one for more savings:
\nEvery theme installs through the Grav package manager with your key, but you can also grab each one as a ready-to-run store. That's a complete Grav site with the theme, KahunaCart and the store setup from its demo (the catalog, services, staff, hours and rates), minus the demo's customers and orders. Your key gets written into the package when you download it, and you'll find them in the Downloads tab of your KahunaCart account.
\nThe packages are also a great way to learn how to set up KahunaCart. Open one up and you can see exactly how its products, options and pages are put together. And if you'd rather not start from scratch, it's a good place to begin.
\nIf your key doesn't cover one of the add-ons a demo uses, that add-on is left out of your package. Any module that needs it will tell you it's missing, and you can install the add-on later or just switch that module off.
\nWe've also rebuilt demo.kahunacart.com from scratch. It now opens on a landing page that lists every demo, with notes at each stop on what to try and how to sign in.
\n![\"The](\"/news/kahunacart-1-6-0/demo-tour.webp\")
\nThe whole site resets every hour, nothing is charged and no emails go out, so go ahead and click on anything you like.
\nA couple of these came straight out of building Encore. A band wants to sell a record as an LP, a CD and a download, and it wants to start selling before the release date. KahunaCart couldn't do either of those before. Now it can.
\nPre-orders. Give a product an Out on date and it sells as a pre-order until that day. The button changes to Pre-order with the date beside it, and the cart, receipt and emails all say when it's out. Payment and stock work the way they always have, so a limited pressing can still sell out. Download links are handed out at purchase but only open on release day, and on the day every waiting buyer gets an \"It's out\" email with their links. After that it's an ordinary product again, and you don't have to change a thing. See Pre-orders.
\nDigital variants. Tick Digital on any variant of a physical product and that variant won't ship anything or ask for an address. So a record in amber vinyl, black vinyl, CD, cassette and download can finally be one product. Physical products can carry files now too, which means you can give every LP buyer the download, or only the buyers of one variant. See Digital variants.
\nWhole Amounts. Flip one switch and the storefront shows $55 instead of $55.00. Prices with cents keep them, and prices shown side by side always use the same format, so you'll never get $55.00 sitting next to $49. Invoices, emails and reports still show full amounts.
Cart, bag or basket. Pick the word your shop uses and every shopper-facing string follows along, from the buy button right through to \"Your bag is empty.\"
\nCoupons from an ad. Put an ad's campaign tag on a coupon and anyone who arrives from that ad gets the code applied for them. You don't have to edit an ad that's already running and send it back through review just to add a code. See Codes that apply from an ad campaign.
\nAnd a bunch of smaller goodies:
\nLICENSE file and links to the KahunaCart License.Update from the admin or with bin/gpm update, then give Slate or Pebble a spin on your own store. I'd love to see what you build with the blocks, so come and show me on Discord!
— Andy
", "date_published": "2026-10-23T08:00:00+00:00", "authors": [ { "name": "Andy Miller" } ], "tags": [ "Release", "1.6.0" ] }, { "id": "https://kahunacart.rhuk.net/news/kahunacart-point-of-sale-available", "url": "https://kahunacart.rhuk.net/news/kahunacart-point-of-sale-available", "title": "KahunaCart Point of Sale", "summary": "Our new Point of Sale add-on turns a tablet, a laptop or a phone into a till on your own site. Take cash or a card on a Stripe, Square or SumUp reader, take returns, and count the drawer at closing. Every sale is an ordinary KahunaCart order, on the same stock as your website.", "content_html": "Plenty of shops don't only sell online. There's a stall at the Saturday market, a counter at the front of a studio, a table at a convention, and a website as well. That usually means two systems: a till app with its own stock count and its own list of sales, and the online store. And somebody has to make the two agree at the end of the week. I wanted one stock and one set of orders for all of it. KahunaCart Point of Sale is available today.
\nPOS runs at /pos on your own site, behind your site's own sign-in. Open it on a tablet, add it to the home screen, and it opens full screen like an app. It works on a laptop too, and on a phone in a pinch.
Every sale it rings up is an ordinary KahunaCart order. It takes stock from the same count as your website, uses your prices, sales, coupons and customer groups, and turns up in your reports next to everything else you sell. Tax is worked out at the address of the place you're selling from.
\nScan a barcode, or tap a product on the favourites grid. Give a staff discount with a reason when a box is dented. Attach a customer if they want their store credit or an emailed receipt. Park a sale while someone runs back to the car for their wallet.
\nThe Pay screen shows what's owed in big type and a button for each way to pay. Cash shows the change large. Cards go to a card reader: a Stripe WisePOS E or Reader S700, a Square Terminal or a SumUp Solo, each through that provider's add-on and your own account with it. The till sends the amount, the customer taps, and the payment lands on the order.
\nYou can split a sale any way you like: put fifty on the card and take the rest in cash. There's also store credit, gift cards, and a pay link drawn as a QR code for the customer to pay from their own phone.
\nI care a lot about the money being right, so the till never guesses. A double tap or a dropped connection records one payment, not two. And if a reader goes quiet halfway through, the till shows the payment as checking and keeps asking the provider until it knows.
\nNo reader yet? The test provider has simulated readers, so you can rehearse a whole day of sales before you buy any hardware.
\nEvery till receipt carries its order number as a barcode. Scan it, pick what's coming back, and the till shows exactly what it will refund and to what before you press the button. Refund to the card, in cash from the drawer, or as store credit. Anything damaged is refunded without going back into stock. And a customer who bought from your website can bring it back to the shop too.
\nMost counters have one tablet and a few people behind it. So the tablet stays signed in, and whoever is serving taps their name and types a PIN. Everything they do is recorded under their name and checked against their own permissions. Someone who can't give refunds can't refund, even on the manager's tablet. When it's needed, the manager types their PIN right there to approve that one return or that one big discount, and the approval is written on the order.
\nOpen a shift with a float. Record cash going out for the bank or coming in from it. At closing, count the drawer by notes and coins. The till asks for your count first and only then shows what should be there, so nobody counts towards a number. Then it freezes the Z report: sales, payments by type, refunds, discounts, takings per person, and the drawer sums. If the drawer is out by more than your limit, you get a message.
\nAll of it lives in a new Point of sale section in your KahunaCart admin, with every register, every shift and its report, and sales reports by register, staff, location or way of paying.
\nIf you run Bookings, a booking that still owes money now has a Take payment button on the front desk. It opens the till with that order ready to pay. When it's paid, Book next visit takes you straight back to the desk to book the customer's next appointment. The till's menu can take what any order still owes, such as an order placed online and paid in the shop.
\nI'd rather you hear this from me than find out at the market.
\nThe hardware page has the full list.
\nPOS needs KahunaCart 1.5.7 or later, the Login and API plugins, and a pickup location for each place you sell. It's a one-time purchase for your site, and updates are covered by your site's single renewal. Card readers come from your payment provider, and so do the card fees. The add-on doesn't add one.
\nAdd it to your licence in the store, install it through Grav's plugin manager, and follow the getting started guide. The add-on page has screenshots of every screen.
\nIf you sell anywhere besides your website, I'd love to hear how the till works for you. Come and tell us on Discord.
\nAndy
", "date_published": "2026-10-14T16:00:00+00:00", "authors": [ { "name": "Andy Miller" } ], "tags": [ "Release", "1.0.0" ] }, { "id": "https://kahunacart.rhuk.net/news/kahunacart-affiliates-available", "url": "https://kahunacart.rhuk.net/news/kahunacart-affiliates-available", "title": "KahunaCart Affiliates", "summary": "Our new Affiliates add-on lets bloggers, podcast hosts and happy customers sell for you. Each partner gets a link, a coupon code or both, their sales are credited to them, and one batch pays everyone at the end of the month. No outside service, no spreadsheet.", "content_html": "When we moved Grav Premium onto KahunaCart last month, one of the things we carried across was an affiliate deal: a cookie, a welcome banner and a discount code for a hosting partner. It turned out nobody had ever used it, and when we looked at why, the answer was simple. There was nothing behind it. No commission was ever worked out, nothing tracked what the partner had earned, and paying them would have meant a spreadsheet. The usual fix is a monthly fee to an outside service that only sees part of what happened to the order. We'd rather it lived in the store, next to the orders and the refunds. So we built it into KahunaCart. KahunaCart Affiliates is available today.
\nEvery partner gets a link to your store, a coupon code, or both. The link is your store's address with ?ref= and their code on the end. It works on every page, and partners can turn any page of your site into a link of their own. The coupon is an ordinary KahunaCart coupon, so it credits the partner on every order that uses it, whether the customer clicked anything or not.
That second part matters more than it sounds. A podcast host reads out a code, and the listener types it in a week later on their phone. There's no click to track, and with most affiliate tools that sale is lost. Here it's credited. A partner like that doesn't even need an account on your store: they share their code, you pay them by PayPal or by hand, and they can get a monthly statement by email.
\nThe referral cookie is listed with the Consent plugin as a marketing cookie. A visitor who says no is remembered for that visit only, or not at all in strict mode, where a coupon is the only way to credit them. The tracking docs explain which to pick. The store keeps a count of clicks per partner per day, and nothing about the visitor.
\nSet one rate for the whole program, then give a partner, a category or a single product its own, as a percent or a flat amount. A commission is worked out on what the customer paid for the goods, after discounts. Tax is left out, and so is shipping unless you choose to pay on it.
\nIf you sell subscriptions with the Subscriptions add-on, partners earn again when a customer they referred renews. Pay on every renewal, a set number of them, or none.
\nEach commission waits out your refund window before it can be paid, 30 days by default. A refund takes back exactly what the refunded items earned. If the partner was already paid, the refund writes a negative amount that comes off their next payout, so nobody has to chase anyone for money.
\nAt the end of the month, build a batch. The preview lists everyone who's owed enough and says why anyone is left out. Partners choose how they're paid:
\nThe add-on never holds anyone's money. Every amount is worked out again when the batch is built, so a refund that came in that morning is counted.
\nPartners fill in a W-9 or a W-8BEN in their account. At year end you get each partner's totals, a flag on US partners who reached the 1099-NEC threshold, a CSV in the layout of the IRS IRIS upload, and a statement PDF for each partner. Full tax ID numbers are stored only when your server has its own key, and they're encrypted with it. Without one, a W-9 keeps the last four digits and the signed PDF.
\nTo be clear about where this stops: KahunaCart collects and totals this information. It doesn't file anything or give tax advice. It gives you the numbers to hand to whoever does.
\nA blogger who has never bought from you shouldn't have to make an account just to ask about your program. So anyone can apply from a public form: their name, email, where they'll share your link and how they'd like to be paid. They confirm their email address, and the application waits for you. Nothing else happens until you decide.
\nApprove it and KahunaCart makes their customer account, with a link in the welcome email to choose a password. Reject it and nothing is made at all, so spam applications never turn into accounts. If the email already belongs to a customer, approving attaches the partner to that account instead. Customers who are signed in get the same form filled in for them. Each application tells you which of these it is, so you always know whether approving makes a new account.
\nYou can also pick a customer group for your partners. Everyone you approve goes in it, and anyone who leaves the program comes out of it. Filter Customers by that group to see your partners, or lock a page to it for brand assets and news that only partners should see.
\nPartners get an Affiliate tab in their customer account. They can apply to join, copy their link, see what's waiting and what's been paid, choose how they're paid and fill in their tax form, all without writing to you. They see the order number and date for each commission, never your customer's name or email. You can add banners and text for them to copy, and put a \"Join our affiliate program\" block on any page with your rate and terms.
\nKahunaCart 1.5.2 came out alongside it, with the store credit movement that pays a partner in credit, and two fixes to merging a store bundle into a running store. 1.5.1 came out a few minutes before it: orders paid through Polar, or Stripe under Managed Payments, now show the tax the provider charged on the receipt, the invoice and the customer's order history, so the total matches what the customer actually paid.
\nAffiliates needs KahunaCart 1.5.2 or later and the store's job worker running. It's $149, a one-time purchase for your site, and updates are covered by your site's single renewal.
\nAdd it to your licence in the store, install it through Grav's plugin manager, and follow the overview and setup guide.
\nIf you run a program with it, or you've been putting one off because of the paperwork, I'd love to hear how it goes. Come and tell us on Discord.
\nAndy
", "date_published": "2026-10-12T12:00:00+00:00", "authors": [ { "name": "Andy Miller" } ], "tags": [ "Release", "1.0.1" ] }, { "id": "https://kahunacart.rhuk.net/news/kahunacart-1-5-0", "url": "https://kahunacart.rhuk.net/news/kahunacart-1-5-0", "title": "KahunaCart 1.5.0: Take your whole store with you", "summary": "Take your store with you. Export everything, or just the parts you pick, into one file you can restore on another KahunaCart site.", "content_html": "KahunaCart 1.5.0 is out, with 16 changes: 11 new features, 3 improvements and 2 fixes.
\nIt started with a question from a store owner. Their shop lived at /shop inside a bigger Grav site, and they wanted it on its own site at its own address. The honest answer was \"copy the files and the database, then delete everything that isn't the shop\". That works. But it's clumsy, and I didn't like that it was the only answer. So 1.5.0 is about your store being yours to take wherever you want.
There's a new Import & Export screen. The Export tab lists everything your store holds, and how many of each:
\nEverything is ticked to start with. Untick what you don't want, press Export, and you get one zip file. Inside is your data, plus copies you can read without KahunaCart: the catalog as a text file, and your customers and orders as CSV files that open in any spreadsheet. I like that part a lot. Even if you never restore a bundle, you have your customers and orders in a form you can use anywhere.
\nCustomer passwords and the keys your store uses to talk to payment providers stay out unless you tick them. If you include the keys, along with saved cards and webhook secrets, they're locked with a passphrase you choose. Every export is kept in History, with who ran it and what it held.
\nA bundle restores in one of two ways.
\nFull restore puts the store into a fresh KahunaCart install with the same order numbers, the same customers and the same orders. If you included passwords, customers sign in with the ones they already have. If you included the keys, saved cards and payment providers keep working too. The one thing that never comes across is whether the store is open, so the new site keeps its own setting.
\nMerge brings a bundle into a store that is already running. It matches products by the last part of their web address, customers by email and orders by number. It never deletes anything, and running the same bundle twice changes nothing.
\nBoth start with a dry run that shows what would happen, and both end with a report. And a restore sends nothing: no emails, no webhooks, no order events. Restored orders are history, not new sales.
\nbin/plugin kahunacart export --bundle store.zip and bin/plugin kahunacart import store.zip --full do the same from the command line, which is the way to go for a big store.
Moving a shop needs a pause, and until now KahunaCart didn't really have one. Turning the cart off left buy buttons around that went nowhere.
\n1.5.0 adds a store status: Open, Coming soon or Paused, with a message of your own. While the shop isn't open, every page shows a banner with your message and nobody can start a new purchase. That goes for shoppers on the site and for apps and AI shopping agents connected to it. Product pages stay up, with \"Coming soon\" or \"Paused\" where the buy button was.
\nEverything else keeps working. Customers can sign in, see their orders, download what they bought and pay what they owe on an order that already exists. Subscriptions renew. Payments in progress still go through.
\nYou can still buy, though. Signed-in staff see the store working, with a banner saying only staff can buy, so you can place a test order before you open. Coming soon also asks search engines not to list the shop's pages. Paused leaves your search listings alone.
\nSwitch it from the dashboard, the General tab of the settings, or bin/plugin kahunacart store --status=paused. It's handy for more than moving, too. Holidays, a stocktake, or a launch that isn't ready yet.
This is the job that started it all. Pause the old shop, export everything, and restore it on the new site. The restore report then gives you a block of redirects to paste into the old site's settings. Every old shop address goes to the same page on the new site, because a restore keeps each product's address.
\nThe docs walk through the whole move step by step, including the part people forget: stopping the old store right after the final export, so nothing lands on a site you're about to switch off. See Moving your shop to its own site.
\nIn KahunaCart's settings, set Shop Base Route to / and the shop is your home page. The product listing is at /, the cart at /cart and products at addresses like /product/reef-runner-tee. Your blog, /about and the admin carry on as before.
If you already have a page at an address the shop uses, like /cart, the shop takes it. bin/plugin kahunacart check lists any of those, so run it before you switch. See Making the shop your home page.
Update through the admin or with bin/gpm update, and come and tell me how it goes on Discord.
A couple of KahunaCart customers asked for Printful this month. One of them was moving a PrestaShop store across, where some products came from Printful's own plugin and the rest went to different printers by SKU range. Nobody wanted to hold stock, and nobody wanted a second shop just for the printed stuff. So we built it into KahunaCart. KahunaCart Print on Demand is available today.
\nYou design a shirt, a mug or a poster in Printful, Printify or Gelato, the same way you would for any other shop. Then you import it into KahunaCart. Its sizes and colours become options, its pictures come across, and each variant keeps what the printer charges you for it, so you set your own price and can see your margin.
\nA customer buys it from your store and pays you, through the same cart and checkout as everything else you sell. The order goes to the printer, the printer makes it and posts it, and the tracking number comes back onto the order. The customer sees it on their receipt and in their account, and gets the usual shipped email.
\nYou can connect all three printers at once. Each product is made by one of them, so checkout never has to choose.
\nThis is the part I care about most. Sending an order to a printer spends your money, and the first few orders through any new setup are the ones most likely to be wrong. So every printer starts in review mode. A paid order becomes a free draft at the printer and waits on the order screen with what it will cost you and what you'll make on it, until you press Send to Printful for $18.40.
\nOnce a few have gone through cleanly, switch that printer to automatic and paid orders go straight to production. A refunded or cancelled sale is checked again before anything is sent.
\nPrintify needs one extra step. A Printify shop sends orders to production by itself after 24 hours unless you set it to Manual order approval, and its API can't tell us which way yours is set. So KahunaCart asks you to confirm it before it will switch Printify on.
\nNot everything you sell has to be designed in the printer's dashboard. If you keep your own artwork, pick the printer's blank for each variant, say a Bella + Canvas 3001 tee in black or an A3 matte poster, and upload a print file for each print area. The store checks each file against the size the printer wants and warns you when it would print soft.
\nThat's also how a big catalogue moves across. Assign by SKU links every variant whose SKU matches a rule, so 7000 to 7999 can go to Printful tees and 8000 to 8999 to Gelato posters. There's a dry run that shows what would change before anything does, and an undo for the whole run. A spreadsheet of links works too, in and out.
\nEach printer adds its own delivery options to checkout, priced live for the customer's address, so what the customer pays for postage matches what the printer charges you. A cart with a printed shirt and a mug you post yourself is two parcels, each with the right options. If a printer can't give a price, your own shipping methods carry on as before, so checkout never ends up with nothing to choose.
\nThe overview has a side-by-side table, and each printer has its own setup page in the docs.
\nThe add-on comes with a pretend printer called Kahuna Print Co. Switch it on for a test store and you get three products, invented postage, and orders that move from made to shipped to delivered on a clock, so every screen has something on it before you sign up anywhere. The demo printer page explains it.
\nIt's running on the live demo too. Put the surf tee in the cart and checkout offers the printer's Standard and Express postage. Then open the admin to see its orders being made and shipped, with the cost and margin on each. The sign-in details are on the demo's login page, nothing is charged, and everything is wiped on the hour.
\nKahunaCart 1.4.7 came out alongside it, with a few things worth knowing about:
\nPrint on Demand needs KahunaCart 1.4.7 or later, the store's job worker running, and a public https address so the printers can send tracking updates. It's $149, a one-time purchase for your site, and updates are covered by your site's single renewal. You'll need your own account with Printful, Printify or Gelato. They bill you for each order they make and its postage, and the add-on doesn't add a fee on top.
\nAdd it to your licence in the store, install it through Grav's plugin manager, and follow the getting started guide.
\nIf you sell merch, prints or anything else a printer could make for you, I'd love to hear how this works for you. Come and tell us on Discord.
\nAndy
", "date_published": "2026-10-11T12:00:00+00:00", "authors": [ { "name": "Andy Miller" } ], "tags": [ "Release", "1.0.0" ] }, { "id": "https://kahunacart.rhuk.net/news/kahunacart-1-4-0", "url": "https://kahunacart.rhuk.net/news/kahunacart-1-4-0", "title": "KahunaCart 1.4.0: Sell in more than one currency", "summary": "One store, several currencies: you type a price in each one, shoppers browse and pay in their own, and every order stays in the currency it was placed in.", "content_html": "KahunaCart 1.4.0 is out, with 41 changes: 17 new features, 11 improvements and 13 fixes. The headline is the one people have asked for most since launch: selling in more than one currency.
\nUntil now a KahunaCart store sold in one currency. If you wanted euros and pounds as well as dollars, you ran three stores or you didn't do it.
\nWith 1.4.0 you keep one base currency and list the others you want to sell in under Configuration → General → Selling in More Than One Currency. Then you type a price for each one. A shopper in Germany browses in euros, pays in euros and gets a receipt in euros. Your accounts in dollars stay exactly as they were.
\nNothing is converted. KahunaCart doesn't look up exchange rates or work a price out for you. You decide that the tee is €29 and £25, not whatever $32 happens to be today. A product with no price in a currency simply isn't sold in it, and the product page says \"Not available in EUR\" instead of guessing. The one exception is free: a product with a base price of 0 is free in every currency.
\nYou can type the prices wherever you already work: in the product editor, with bulk edit, in a CSV file or in the catalogue file. Every currency gets its own column, and JPY gets no decimals while KWD gets three.
\nA price is only one of the amounts a store charges. Coupons, sales, price lists, quantity tiers, order minimums and maximums, payment method fees, shipping methods, collection point fees and store credit all take an amount per currency now. There is one rule for all of them: if there's no amount in a currency, the rule doesn't apply there. A \"€5 off\" coupon with no dollar amount simply doesn't work on a dollar cart. It never turns into $5 or $0.
\nKahunaCart works out a shopper's currency from what it knows: a choice they already made, the country on their address, or a country header from your CDN, such as Cloudflare's CF-IPCountry. A switcher in the header lets them change it, and ?currency=EUR on a link opens a page in euros.
Once a shopper has a cart, the cart's currency wins. Switching moves the whole cart: every line is priced again in the new currency, and anything with no price there is taken out and named. If a cart already had a payment page opened at a provider, it keeps its currency for good and offers Start a new cart in EUR instead, so no payment is ever left pointing at the wrong amount.
\nEvery order is in exactly one currency, from the cart to the last refund. Lines, shipping, tax, payments, refunds and order changes are all in that currency, and invoices and emails print it.
\nReports, the dashboard, customer lifetime spend and cart recovery add up one currency at a time, with a picker to choose which. They never add euros to dollars and call the result a total.
\nPayment methods that can't take an order's currency aren't offered for it. Every payment provider plugin has an update for this release, and Stripe 1.2.6 sends Icelandic krona, Ugandan shilling and Malagasy ariary at the scale Stripe expects.
\nSubscriptions 1.1.5, Bookings 1.1.5, Rentals 1.0.6 and Shipping 1.1.7 all price in each currency you sell in, and a subscription renews in the currency it started in.
\nAI shopping agents get the same treatment. The storefront API, the storefront MCP endpoint, UCP checkout, the product feeds and the structured data on product pages all work in every currency you sell in.
\nIf you use a CDN, one rule keeps it simple: a page is only cached publicly when its address decides the currency. The caching section of the guide explains how to set that up.
\nA store that sells in one currency sees no change. If you never list a second currency, the storefront and the admin look and work as they did, and the new tables stay empty. Want to try it first? bin/plugin kahunacart seed --currencies=EUR,GBP fills a demo store with prices in euros and pounds.
When the first numbers came back from our new dedicated benchmark server, I asked a simple question: is there room left? The category page on MariaDB topped out at 69 requests a second, while a product page on the same box managed 145. A listing shouldn't cost twice as much as a product. So I put a profiler on it, and the answer turned into KahunaCart 1.3.6.
\nSame server, same store of 5,000 products and 250,000 orders. That category page now handles 189 requests a second. Search on MariaDB went from 75 to 186. Capacity went up on every route we measure, on all three database engines.
\nThe biggest single cost was hiding in the filter panel. Next to each tick box on a category or search page, the store shows how many products match. To decide which values to offer at all, it also counted every attribute value across the whole catalog, on every request. On MariaDB that was 67 to 70 ms of database work per page, most of the time the page spent in the database. Those counts only change when the catalog does, so now they're kept until it does. The category counts in the navigation got the same treatment.
\nSmaller things added up:
\nThe biggest jump in search wasn't a slow query. It was a bug, and it could hit a live store.
\nWhen the product search index looked out of date (after a deploy or a restore without the data folder, or a bulk import that wrote products directly), the next shopper to search rebuilt the whole index inside their own request. That takes about 13 seconds. Worse, every other search that arrived in those 13 seconds saw the same out-of-date index, started a rebuild of its own and deleted the one in progress. Under steady search traffic they just kept knocking each other over. Over two days of load tests, the benchmark store rebuilt its index 2,367 times.
\nAnd it had been running in every benchmark we'd taken. That's why search always looked like the weak spot. It was running during the first 1.3.6 run as well, so we withdrew that run and took a new one after the fix.
\nNow only one rebuild runs at a time, in the background, into a new file. The old index keeps answering searches until the new one is complete and switched in. If there's no usable index yet, searches fall back to a plain database search, so a shopper never waits on a rebuild. While I was in there, I found search was also asking the index for a highlighted snippet of every match (several hundred for a common word) and then reading only the ids. It asks for the ids alone now.
\nSearch capacity roughly doubled on SQLite (125 to 258 requests a second) and PostgreSQL (73 to 140), and went from 75 to 186 on MariaDB. Search is now strong on every engine.
\nEvery product save and every stock movement reindexes that product. On MySQL and MariaDB, the catalog index deleted and re-inserted all of the product's rows each time. But InnoDB keeps deleted rows in a full-text index until somebody optimizes the table, and nobody ever does. One upgrade and reindex left our benchmark store with 30,000 dead entries on 15,000 live rows, which made searches 2 to 10 times slower. A busy store would have got slower with every sale. The index now writes only the rows that changed, and a full rebuild finishes by optimizing the table.
\nOrder search on MySQL and MariaDB went from about 260 ms to about 5 ms. It tries an exact order number or email address first, and it stops asking the full-text index about words that almost every order shares, like a common email domain or your order number prefix. Reports are about 30% faster on SQLite and PostgreSQL.
\nGrav 2.2.3 ships alongside, and it brings its own share. Grav 2 runs Twig in page content inside a sandbox, which checks every call so nothing dangerous can be done from a page. Theme and plugin templates were paying for those same checks, even though they're code you chose to install. Grav's Twig fork now compiles them without the sandbox checks, and a listing template renders about twice as fast, within about 5% of no sandbox at all. It also moves to Twig 3.30. In a test on PostgreSQL, the Grav update on its own was worth 4 to 9% of capacity, and every Grav site gets it, store or not.
\nCapacity here is the most requests a second a page sustained with 95% of them answered in under 500 ms. Same 8 vCPU server and the same store, KahunaCart 1.3.5 with Grav 2.2.1 against KahunaCart 1.3.6 with Grav 2.2.3:
\n| Page | \nSQLite | \nMariaDB | \nPostgreSQL | \n
|---|---|---|---|
| Home | \n224 → 352 | \n112 → 209 | \n127 → 189 | \n
| Catalog | \n171 → 274 | \n111 → 191 | \n79 → 143 | \n
| Category | \n115 → 252 | \n69 → 189 | \n74 → 135 | \n
| Product | \n233 → 361 | \n145 → 228 | \n129 → 154 | \n
| Search | \n125 → 258 | \n75 → 186 | \n73 → 140 | \n
Under the normal mixed workload of browsing, carts and checkouts, 95% of catalog pages came back within 64 ms on SQLite (down from 94), 90 ms on MariaDB (from 151) and 104 ms on PostgreSQL (from 175). One request failed out of 73,111 across all three engines. Every route, the full method and every earlier run are on the benchmarks page, and the performance page explains in plainer terms why the store is fast.
\nThis one is not in the published numbers. KahunaCart 1.3.6 adds a Persistent Connections setting for stores on MySQL, MariaDB or PostgreSQL, and it's off by default. Turn it on and each PHP worker keeps its database connection open between requests instead of opening a new one every time. A new PostgreSQL connection costs about 7 ms, which is a big slice of a page that otherwise takes a few dozen. In a separate test on the same server, it raised PostgreSQL capacity by 50 to 65%: the home page went from 187 to 306 requests a second and the catalog from 132 to 197.
\nThe catch is that every worker holds a connection even when it's idle, so your database's max_connections has to cover every PHP worker you run, plus the scheduler. That's why it's off. If you run your own database server and know those numbers, I'd turn it on. The setting now lives in Grav's shared database kit, so Forum Pro and Mailroom get the same setting in their next releases.
Update Grav to 2.2.3 and KahunaCart to 1.3.6 or later (1.3.7 followed the same day with a checkout fix), from the admin or with bin/gpm self-upgrade and bin/gpm update kahunacart. The database migrations run as usual. That's it, nothing else to change.
If you want to see what your own hosting can do, the benchmarking guide shows how to seed a store this size and time it. And if you run the numbers, I'd love to see them on the KahunaCart Discord.
\nAndy
", "date_published": "2026-09-29T12:00:00+00:00", "authors": [ { "name": "Andy Miller" } ], "tags": [ "Article" ] }, { "id": "https://kahunacart.rhuk.net/news/kahunacart-1-3-0", "url": "https://kahunacart.rhuk.net/news/kahunacart-1-3-0", "title": "KahunaCart 1.3.0: AI shopping agents and Squarespace import", "summary": "AI shopping agents in Google AI Mode, Gemini and ChatGPT can now find your products and buy them, and a Squarespace store moves in with one command.", "content_html": "KahunaCart 1.3.0 is out, with 40 changes: 20 new features, 13 improvements and 7 fixes. It's the first minor release since launch, and the headline is agentic commerce.
\nPeople are starting to shop inside AI assistants, and I wanted KahunaCart stores ready for it. With 1.3.0, Google AI Mode and Gemini can put one of your products in a basket and pay with Google Pay without the buyer ever leaving the conversation. ChatGPT can find your products through the OpenAI product feed. And any MCP client (Claude, Cursor, a ChatGPT connector) can search your catalog and build a cart.
\nIt comes in four parts that build on each other:
\nAn agent sees exactly what a logged-out visitor sees. It can't sign in, it can't set a price, and it never sees a stock count or a cost. Prices, tax and shipping come from your store, worked out by the same calculator the storefront uses. If an agent can't finish a purchase itself (a subscription, a deposit or a pay-what-you-want product, say), the buyer lands on your own checkout with the cart already filled.
\nAgent orders get their own agent source in reports, so you can see what the assistants actually sell for you. A new Mark delivered button on each shipment tells the platform when the parcel arrived.
All of it is off until you turn it on. A store that never opens the new Settings → Agentic Commerce tab sells exactly as it did on 1.2. The agentic commerce docs walk through the setup for each platform.
\nSquarespace doesn't give you one export. You get a products CSV, an orders CSV, a customers CSV and a WordPress export of the site, and none of them fit an importer as they come. Put all four in one folder and run:
\nbin/plugin kahunacart squarespace <folder>Products come in with every variant, price, sale price and stock level. Pictures are downloaded from Squarespace's servers before those links stop working. Customers and orders keep their numbers, dates and totals, the site and blog become Grav pages, and you get redirects from every old Squarespace address to its new one, ready to paste into site.yaml.
--dry-run writes nothing, and running it again updates instead of duplicating. We tested it against a real store's exports, not sample files. The importing docs cover which exports to download and what comes across.
Product search now looks at each product's categories, tags, brand and attributes, so tops finds a tee filed under Tops. That's on for everyone.
Switch on semantic search as well and the storefront ranks by meaning, not just keywords. A search for hat finds the cap and the beanie. It works with any OpenAI-compatible embeddings API, including OpenAI, OpenRouter or Ollama on your own server, and it measures its own noise level on your catalog so a search for asdf doesn't come back with random products. Leave it off and search works exactly as before, with nothing sent anywhere. See Semantic search to set it up.
Grav 2.2 came out today with lazy sessions. Turn them on and shoppers who are only browsing no longer get a session cookie from the store, so a proxy or CDN can cache those pages. Orders still record where a shopper came from, and signing in from a store page still brings them back to it.
\nUnder the covers, the database layer moved to our shared grav-db-kit package. Add-ons built for 1.2 keep working unchanged.
\nUpdate from the admin or with bin/gpm update kahunacart. The full list is in the changelog, and questions and feedback are welcome on the KahunaCart Discord.
Andy
", "date_published": "2026-09-24T12:00:00+00:00", "authors": [ { "name": "Andy Miller" } ], "tags": [ "Release", "1.3.0" ] }, { "id": "https://kahunacart.rhuk.net/news/kahunacart-bookings-rentals-available", "url": "https://kahunacart.rhuk.net/news/kahunacart-bookings-rentals-available", "title": "KahunaCart Bookings and Rentals", "summary": "Two new add-ons let your shop sell time as well as things. Bookings takes appointments and classes and gives your staff a front desk. Rentals adds nightly stays on top, with seasonal rates, deposits and calendar sync with Airbnb, VRBO and Booking.com.", "content_html": "When I started on KahunaCart, the plan was a shop for things: downloads, licences, subscriptions, boxes in the post. But a lot of people who run small businesses on Grav don't sell things at all. They sell an hour in a chair, a spot in a Tuesday class, or a week at the beach. Until now they needed a separate booking service for that, with its own checkout, its own customer list and its own monthly bill. So we built two add-ons that do it inside your shop. KahunaCart Bookings and KahunaCart Rentals are available today.
\nSet a product's type to Booking and its page grows a calendar. Customers see the free days and times, pick a staff member if you allow it, and pay through the same cart and checkout as everything else in your store. Picking a time holds it for fifteen minutes while they finish. You can also take payment on the day, and free bookings skip the cart entirely.
\nThe part I'm proudest of is how it handles what a service needs. A dog groom needs a groomer and a tub. A haircut needs a stylist and a chair. You list your people, rooms and equipment, tell each service what it needs, and the shop only offers times when everything is free. Ten identical axe lanes are one record with a capacity of ten, not ten records you have to keep in sync.
\nAlso in the box:
\nThe front desk is the piece I'd show a salon owner first. Give your reception tablet a site account with front desk access and open /desk. Staff see the day in columns, tap to check someone in, press and hold to move an appointment, and use New booking for walk-ins and phone calls. Each appointment shows what's owed in plain words, like Deposit paid, $25.00 to pay today.
Desk staff never see the admin, your orders, your payment providers or refunds. You can give reception the whole diary or give a stylist just their own column.
\nRentals sits on top of Bookings and adds nightly stays for holiday lets, B&B rooms, cabins, pitches or anything else you rent by the day. Guests pick arrival and departure dates on a calendar that shows availability and changeover days, and they get an itemised quote before they pay.
\nYou set the rules once per property:
\nRentals also swaps calendar links with Airbnb, VRBO and Booking.com, so a stay booked there blocks the nights on your site, and a stay booked on your site blocks them there. Only \"Not available\" and two dates go out. Guest names and prices never leave your server. Calendar sync runs on each site's refresh schedule, so two sites can still sell the same dates in between. The channel sync docs explain how to handle that when it happens.
\nThe demo now runs three made-up businesses, each with its own look:
\nBook something, then open the front desk or the admin to see it from the owner's side. The sign-in details are on the demo page, nothing is charged, and every booking is wiped on the hour. The Bookings and Rentals pages have screenshots of every screen too.
\nA few things went into KahunaCart itself while these were being built, and they're useful well beyond bookings:
\nBookings and Rentals need KahunaCart 1.2.11 or later.
\nEach one is a one-time purchase for your site, and updates are covered by your site's single renewal. If you buy the two separately in one cart, the store will offer you the bundle and save you $49. Add them to your licence in the store, install them through Grav's plugin manager, and follow the Bookings setup guide. The docs include ready-made examples for salons, groomers, personal trainers, massage therapists, ranges, holiday lets and a four-room B&B, each with a seed command that builds a working setup you can poke at.
\nIf you run a salon, a studio, a range or a holiday let on Grav, I'd really like to hear how this fits your business. Come and tell us on Discord.
\nAndy
", "date_published": "2026-09-22T12:00:00+00:00", "authors": [ { "name": "Andy Miller" } ], "tags": [ "Release", "1.0.0" ] }, { "id": "https://kahunacart.rhuk.net/news/kahunacart-shipping-available", "url": "https://kahunacart.rhuk.net/news/kahunacart-shipping-available", "title": "KahunaCart Shipping is here: from checkout to the doorstep", "summary": "Our new Shipping add-on connects Shippo, EasyPost and ShipEngine to KahunaCart, with live carrier rates, box packing, shipping labels and parcel tracking in your store admin.", "content_html": "Taking an order is only half the job when you sell physical products. The other half is working out the postage, finding the right box, printing a label and keeping the customer informed until it arrives. KahunaCart Shipping is now available, bringing that work into the same admin where you manage your store.
\nChoose Shippo, EasyPost or ShipEngine, connect your account and enable the carrier services you want to offer. That gives your store access to services from carriers such as USPS, UPS, FedEx and DHL, depending on your provider account and location. You choose one shipping provider for the store and create a shipping method for each service you want customers to see.
\nLive rates work alongside KahunaCart's existing shipping methods. You can keep your flat rates and nominate a fallback method so customers can still check out when a carrier cannot return a quote.
\nAdd your box sizes, weight limits and product measurements, and Shipping works out how an order fits into parcels. It accounts for dimensional weight as well as the weight on the scale, so a large, light item does not get treated like a small one.
\nYou can inspect the proposed packing before buying anything: which box each parcel uses, what is inside it and which weight the carrier will bill. Orders that need more than one box get more than one parcel.
\nOpen an order, review its parcels, choose a service and buy the labels from the admin. Shipping fetches a fresh quote and puts the price on the purchase button, so you know what you are about to spend. The labels are kept on your server for printing, and the tracking numbers are recorded against the order.
\nFor international parcels, Shipping builds the customs declaration and identifies missing product details before you buy. If you need to void an unused label, you can request that from the admin too, subject to the carrier's rules.
\nCustomers can follow their parcels from their receipt and account page, with tracking links and delivery updates by email. Tracking updates arrive through webhooks, with background polling as a backup.
\nThe release also makes webhook setup a pair of actions on the Shipping carriers screen: generate the secret, then register the webhook with your provider. Keep your store's scheduler running so tracking and customer notifications continue in the background.
\nThe built-in demo carrier quotes rates, produces sample labels and simulates a parcel's journey without contacting a shipping provider or charging for postage. It is also running on the live demo, where you can browse the read-only admin using the sign-in details on its login page. The Shipping page has screenshots of the carrier settings, packing, labels and tracking.
\nShipping is a separate add-on for KahunaCart 1.2.10 or later. Add it to your licence in the store, install it through Grav's plugin manager and follow the setup guide to connect your provider, add a ship-from address and configure your boxes and services.
\nThe add-on is a one-time purchase for your site, with updates covered by your site's single renewal. Postage and any shipping-provider fees are paid separately through your provider account.
\nIf you sell physical products with Grav, I would love to hear how it works for your store. Come join us on Discord.
\nAndy
", "date_published": "2026-09-16T12:00:00+00:00", "authors": [ { "name": "Andy Miller" } ], "tags": [ "Release", "1.1.0" ] }, { "id": "https://kahunacart.rhuk.net/news/kahunacart-available", "url": "https://kahunacart.rhuk.net/news/kahunacart-available", "title": "KahunaCart is out. Go build a store.", "summary": "The cart is open, 1.2.8 is on GPM, and the first 50 customers still get 50% off and the founders renewal rate. Here is what you get and how to have a shop running in an hour. (Early access ended on 13 October 2026.)", "content_html": "I have wanted this for about eight years. Every time someone asked \"can I sell things with Grav?\" the honest answer was a shrug and a link to a hosted cart that hijacks your checkout page, your customer data and a slice of every sale. I wanted the opposite: a shop that lives inside a real Grav site, on your server, in your theme, with your content around it. So we built one. Today KahunaCart is for sale, 1.2.8 is on GPM, the docs are up, the demo is up, and there is a Discord server waiting for you.
\n$249 per site, once. That buys the whole platform, the first year of updates and support, and no transaction fees, ever. Unlimited products. Unlimited orders. Unlimited customers. Stripe, Polar, PayPal, offline payments and a test provider are in the box, so you can take money the same afternoon.
\nThree add-ons are available today, and each one attaches to the same licence key:
\nAfter the first year, renewal is $99 and optional. It is per licence and it covers everything on that licence. Just KahunaCart? $99 renews KahunaCart. KahunaCart plus all three add-ons on one key? The same $99 renews all four. And if you skip a year, nothing switches off. I have paid enough per-extension renewals in my life to know how it feels, and I was not going to do that to you.
\nUpdate: early access ended on 13 October 2026. The founders who bought with a code keep their $49 renewal for the life of the licence.
\nIf you are on the launch list, go check your inbox. Your email has a code worth 50% off KahunaCart and every add-on, good for thirty days, and buying with it puts you in the founders group with a renewal of $49 a year for the life of the licence.
\nNot on the list? You have not missed it. Sign up on the homepage and the same code comes straight to you. The offer is for the first 50 customers. Your code works up to five times, so you can come back for an add-on or a second licence, and it closes when the fiftieth customer has bought. But there is a catch, and it is the good kind: I want to hear what breaks. Early access exists so the rough edges get found by real stores before the wider launch, and I read every reply.
\nKahunaCart needs Grav 2.1.0, which shipped last week. Put your key in user/data/licenses.yaml and run:
bin/gpm install kahunacartPrefer clicking? Install it from Plugins in the admin and enter the key through License Manager. Prefer skipping all of that? Your account page has a ready-to-run package: a complete Grav site with KahunaCart, every add-on your key covers, the free Kahuna theme, a sample catalogue and your key already inside. Unzip it, point a web server at it, and you are looking at a store. The Getting started chapter takes it from there.
\nThis is a 1.2 release, not a 1.0. There are 15,000 automated tests behind it, across the core and the add-ons. The published benchmark serves a catalogue page in 204 ms at the 95th percentile with 250,000 orders in SQLite, on a two-core server. The nine payment providers beyond the bundled four are built and tested and marked coming soon on the site. They go out as customers ask, so if you need Mollie, Paddle or Square, tell me and you will move it up the list.
\nWant to kick the tyres first? The live demo resets every hour. Break whatever you like.
\nThe KahunaCart Discord is where the questions, the bugs and the opinions go, and I am there most days. The docs cover every screen, and the store has the plain answers on renewals and add-ons.
\nThank you to everyone who signed up early, and to the Grav community for years of patience while I built this. It is a very good day. Go build a store!
\nAndy
", "date_published": "2026-09-14T08:00:00+00:00", "authors": [ { "name": "Andy Miller" } ], "tags": [ "Article" ] }, { "id": "https://kahunacart.rhuk.net/news/kahunacart-1-2-0", "url": "https://kahunacart.rhuk.net/news/kahunacart-1-2-0", "title": "KahunaCart 1.2.0: Checkout and store operations", "summary": "Cart recovery, configurable checkout fields, consolidated settings, expanded shipping and tax options, and faster reporting.", "content_html": "KahunaCart 1.2.0 adds 66 changes to checkout and store operations. It remains a private release, with early access planned for a later version.
\nCart recovery emails include a signed link that restores the cart using current prices. The workflow sends one reminder, and the Recovery screen reports restored carts and the recovery rate.
\nCustomers can also receive shared-cart links and email sign-in links. The email log records messages and retries. Order notices preserve changes such as an expired coupon or unavailable item, while a separate queue highlights orders requiring staff attention.
\nCheckout fields can be configured with conditions and placed in four template regions. Add-ons and merchants can add fields such as delivery dates or gift messages without overriding a template.
\nCountry records hold editable address layouts, required fields, postcode rules and phone rules. The system covers 249 country records, with approximately sixty address layouts described in this release. Pickup locations add addresses and opening hours, with tax based on the collection location. Quantity limits and deposits provide more control over purchases and payment timing.
\nStore settings are available within the KahunaCart admin, with search and detection of conflicting options. Configuration can be exported and imported between stores.
\nOrder, payment and fulfillment statuses have explicit behavior flags, including whether they count as paid, affect stock or represent a final state. Customer-facing labels can differ from internal labels.
\nShipping supports six rate types, cost expressions, class policies and multiple parcels with separate methods. Unavailable methods display a reason. Live carrier integrations remain outside core.
\nTax-inclusive pricing can vary by region. Tax tables support compound rates and CSV import and export, with an extension interface for regional tax services.
\nFiltered reports are ten times faster in the measured workload, and a migrator memory leak has been fixed. The published mixed-load SQLite run recorded a median of 147 ms and p95 of 377 ms on the 2 vCPU server with 250,000 orders, with zero errors. See the benchmarks for the test conditions.
\nCompensating hooks pair an add-on action with an undo. If a later step fails, completed actions are undone in reverse order. Five lifecycle points support this: order completion, payment capture, fulfillment creation, cancellation and refund. The event list now contains 71 events.
\nAnalytics adds period comparisons, twelve metrics, sixteen filters and shareable views. Orders record their source, while item costs and margin are recorded at sale time so later price changes do not alter historical figures.
\nThe documentation covers setup and behavior. Questions and feedback are welcome on the Grav Discord.
\nAndy
", "date_published": "2026-09-02T18:00:00+00:00", "authors": [ { "name": "Andy Miller" } ], "tags": [ "Release", "1.2.0" ] }, { "id": "https://kahunacart.rhuk.net/news/kahunacart-1-1-0", "url": "https://kahunacart.rhuk.net/news/kahunacart-1-1-0", "title": "KahunaCart 1.1.0: Payments and add-on development", "summary": "Payment authorization, saved methods, express checkout and new interfaces for custom fields, add-ons and integrations.", "content_html": "KahunaCart 1.1.0 adds 58 changes focused on payments and extension development. It follows two fixes for report date ranges and misspelled searches on small stores. This remains a private release; early access will open later.
\nSupported providers can reserve the payment amount at checkout and capture it later. This lets staff check stock or prepare an order before collecting payment. If the order is cancelled, the authorization can be voided instead.
\nStripe, PayPal, Checkout.com, Mollie and Shopify support this workflow. Payment records, order status and events track the result.
\nStripe is the first implementation of saved payment methods, using a provider token associated with the customer. It also supports off-session charging.
\nThe cart and checkout have designated locations for Apple Pay, Google Pay and Link buttons. A shared styling contract lets themes present supported providers consistently.
\nProvider credentials are encrypted when saved. Capability documentation is generated from provider declarations and checked by tests. All 13 providers now declare the 1.1.0 contract, with subsequent changes following semantic versioning.
\nTyped custom fields can be added to products, variants, orders, order items, customers and addresses. They use indexed columns and can be declared by an add-on or configured by a merchant.
\nAdd-ons also gain a settings store, thirteen interface extension zones, named event constants and five plugin generators. The test harness provides an in-memory store for add-on tests.
\nStore emails are listed in one place with enable controls and template selection. Staff can preview messages against an order without sending them. Object templates provide editable formats for references, filenames and subjects.
\nOutbound webhooks support signed deliveries, retries and a delivery log. The storefront JSON API provides cart and checkout operations for JavaScript frontends and can be disabled in configuration.
\nThe check command runs nine installation checks. The release also adds a job-queue screen, test-data reset options and reports for outdated template overrides. Admin tests identified and fixed two screens that failed when opened.
\nSee the documentation for configuration and developer details, or join the Grav Discord to discuss the release.
\nAndy
", "date_published": "2026-09-02T09:00:00+00:00", "authors": [ { "name": "Andy Miller" } ], "tags": [ "Release", "1.1.0" ] }, { "id": "https://kahunacart.rhuk.net/news/kahunacart-1-0-0", "url": "https://kahunacart.rhuk.net/news/kahunacart-1-0-0", "title": "KahunaCart 1.0.0: Core store features", "summary": "The first internal release brings catalog, checkout, orders, tax, shipping, promotions, downloads and customer accounts to Grav.", "content_html": "I've been building Grav since 2014, and store owners have often asked how to add ecommerce to their sites. KahunaCart is my answer: a store that uses Grav's theme and admin while keeping commerce records in a database.
\nKahunaCart 1.0.0 is the internal milestone for the core store features. It includes 342 changelog entries. At this stage, only two of us have installed it and it is not yet for sale. Early access will open with a later version.
\nProducts, orders, customers and price adjustments use SQLite, MySQL or PostgreSQL. Grav content, templates and configuration remain in files. SQLite is the default and does not require a separate database server.
\nThe storefront includes 27 Twig templates and 42 Twig functions. Themes can override individual templates or add product grids, buy buttons and cart components to existing pages.
\nPrices use currency-aware calculations in minor units. Order numbers and stock changes use database transactions. Staff can configure order statuses and prepare order changes before confirming them.
\nStore credit and gift cards share a transaction ledger. Refunds can return to the payment provider, store credit or both, with credit notes recording the refund.
\nPrice lists, quantity tiers, customer groups, coupons and sales cover several pricing models. Promotions include buy-one-get-one and cheapest-item-free offers. The documented price-selection rules have corresponding tests.
\nThe release also includes ranked product search, partial shipments, tracking numbers, packing slips and CSV imports with saved mappings and previews. Reports use daily summaries to reduce repeated work on the order history.
\nThe benchmark dataset contains 5,000 products, 25,000 customers and 250,000 orders. On the published 2 vCPU server, SQLite catalog requests reached a p95 of 204 ms with no errors, down from approximately 7.4 seconds before the performance changes. The benchmark page includes the workload and earlier runs.
\nThe release has 5,235 test methods. Tests also check the administration API documentation and MCP manifest against the implementation.
\nThe next releases focus on payment integrations, add-ons and day-to-day operations. The documentation covers the current features. You can also find me on the Grav Discord.
\nAndy
", "date_published": "2026-08-31T12:00:00+00:00", "authors": [ { "name": "Andy Miller" } ], "tags": [ "Release", "1.0.0" ] } ] }