You're viewing the documentation of an older Simple Commerce version. Consider upgrading to the latest for new features and bug fixes.



Released on 19th February 2021

  • Fix Tax amounts should no longer be off. Was previously using the wrong formula.


Released on 13th November 2020

  • Fix Fix issue where gateways were not being booted


Released on 5th November 2020

  • New Licensing statistics - so we can check how many sites are using Simple Commerce, what versions are in use and if they have valid licenses. (also introduced in v2.1.2)


Released on 4th October 2020

  • New You can now update the format of the customer titles.
  • Fix When updating a customer, sometimes the title would be removed... #311
  • Fix If updating a customer's name using {{ sc:cart:update }} tag, it wouldn't work because of some copy and pasting
  • And added a bunch of customer related tests...


Released on 4th October 2020

  • Fix Fixed a bug that would happen if you try and get a customer that doesn't have a title or slug set.


Released on 4th October 2020

  • Fix Fixed issue where SC would presume a customer entry had a name on it, but if it didn't then stuff would break.


Released on 4th October 2020

  • Fix Fixed issue with customer data when being passed into Stripe Gateway, from #307


Released on 3rd October 2020

  • Fix Fixed issues when creating/updating customers via the {{ sc:cart:update }} tag. #307


Released on 30th September 2020

  • Fix Fixed issue with decimals causing incorrect totals, when using coupons on an order #304


Released on 28th September 2020

  • New Payment Method's are now saved for later, with Stripe Gateway #306


Released on 5th September 2020

  • Fix The money fieldtype will now default to 0 when nothing is entered instead of throwing an exception.
  • Fix Fixed issue where you couldn't remove the last item from the cart


Released on 29th August 2020

  • New You can now register gateways on-demand with SimpleCommerce::registerGateway(PayPalGateway::class, [])
  • Fix Fixed issue where deleting a single cart item would clear the cart instead (again) #293
  • Fix Fixed issue when trying to submit checkout form without any customer information.


Released on 27th August 2020

  • Fix Fixes issue when adding to the cart when you've already deleted items from the cart. #293
  • Fix Generate a title and slug for customer if they don't already have one - fixes a type error #296
  • Fix Fixed issue when the CheckoutController tries to call the PreCheckout event on case sensitive systems. #294


Released on 26th August 2020

  • New Brought back Order Statuses, you may want to run php please simple-commerce:setup-command to create the relevant taxonomies and terms.
  • New You can now send customer metadata when using {{ sc:cart:update }} and {{ sc:checkout }} tags. #289
  • New You can now toggle if Simple Commerce sends an Order Confirmation email to your customers after checkout. It's enabled by default. #288
  • New Customer & Order information is now passed to Stripe when preparing payment intent #292
  • New Brand new php please simple-commerce:setup-command command for setting up collections & taxonomies when installing Simple Commerce
  • Fix Fixed issue where adding items to cart would overwrite what is already there. #290


Released on 24th August 2020

  • Fix Fixed issue with ProductRepository not being bound properly because of a spelling mistake 🤦‍♂️ #287


Released on 22nd August 2020

  • New You can now specify the version of the Stripe API you want to use.
  • Fix Fixed issue caused when using a gateway that doesn't return anything from the prepare method.
  • Fix Fixed checkAvailability failing for shipping methods
  • Fix Fixed issue with completing cart without a customer being attached to the order.
  • Changed version constraint of statamic/cms due to v3 release


Released on 18th August 2020

  • Fix Simple Commerce releases should now include built assets.
  • Fix Issue when entering value inside Money fieldtype without separator and it converts it to cents/penies
  • Fix Percentage coupons #281


Released on 17th August 2020

  • Fix Simple Commerce tags were broken after beta 44


Released on 17th August 2020

  • Fix Config, blueprint etc should no longer be overwritten on composer update
  • Simple Commerce only supports PHP 7.4


Released on 14th August 2020

  • New Refunds - somehow managed to ship without refunds but they're here now!
  • New The output from prepare methods in gateways is now saved in the order so it can be used again in the gateway
  • Breaking change Really small breaking change, inside the {{ sc:gateways }} loop, change {{ config:* }} to {{ gateway-config:* }} to grab gateway configuration values.
  • Fix Fixed initial state for the money fieldtype, should no longer show .
  • Fix Exceptions should now be thrown for when gateways don't exist or none is required at checkout
  • Fix _redirect should no longer be passed into cart when updating cart
  • Fix Fixed issue with coupon validation, where an error was being thrown as we were validation the wrong thing 🤦‍♂️ #276


Released on 11th August 2020

  • Fix Blueprints being re-published after every Simple Commerce update


Released on 10th August 2020

  • Fix Simple Commerce no longer relies on calebporzio/sushi for Currency and Country models
  • Fix Incorrect typehint causing issues when getting cart items
  • Fix Typos


Released on 6th August 2020

  • New Introduced a Product facade, repository and related things...
  • Fix Fixed bug where you'd run into an error if you visit the cart/checkout when you have no cart in the session. Fixes #275
  • Breaking change The $request variable is now passed in as a second parameter of the purchase method to a gateway.


Released on 1st August 2020

  • New Introduced two new commands: make:gateway and make:shipping-method
  • Fix Use FormRequests for validating action endpoints
  • Fix Officially only supports PHP 7.4
  • Breaking change Removed /shipping-options endpoints.
  • Breaking change Removed need for SKUs, you can have them if you want them but they won't be saved in orders anymore.


Released on 1st August 2020

  • New Added PreCheckout and PostCheckout events, triggered by the Checkout controller.


Released on 25th July 2020

Simple Commerce v2.0 has launched!


Released on 23rd July 2020

  • New Revamp of Customers - they now belong in their own collection instead of using Statamic users.
  • New Better order numbering
  • Breaking change Usage of {{ sc:customer }} tags have changed, find the new usage on the documentation.
  • Breaking change CartRepository has been refactored, if you're dealing with it programatically, there's likely some updates you'll need to make. Otherwise, this change shouldn't affect you.


Released on 21st July 2020

  • New A tag to check if user has a cart {{ sc:cart:has }}
  • Fix Updated blueprints stuff for Statamic Beta 38
  • Fix Receipt would error out if no customer is assigned to cart
  • Fix Post-checkout success flow - more info on #270
  • Fix Product Categories taxonomy is attached to products when setting up
  • Order Statuses have been removed from Simple Commerce. Feel free to delete the taxonomy if you're not using it.


Released on 21st July 2020

  • New Improved the way tax is handled
  • Fix Roll back some code to do with creating collections when user installs


Released on 20th July 2020

  • New You can now change the collections and taxonomies Simple Commerce uses. More information over on the docs, under Collections & Taxonomies
  • New Simple Commerce views (including emails & the receipt template) are now publishable php artisan vendor:publish --tag=simple-commerce-views
  • Fix Removed a 'revenue widget' - didn't even work
  • Fix Translated some more strings
  • Fix Issue where you could checkout the same order twice. Yikes.
  • Fix Left out the {{ customer:order }} tag, now implemented.

Small changes

You'll probably want to add this to your config/simple-commerce.php file.

'collections' => [
        'products' => 'products',
        'orders' => 'orders',
        'coupons' => 'coupons',

'taxonomies' => [
        'product_categories' => 'product_categories',
        'order_statuses' => 'Order Statuses',


Released on 18th July 2020

  • New Coupons are now a thing!
  • New Text coming from Simple Commerce now comes from language files


Released on 15th July 2020

  • Simple Commerce assets (fieldtypes) are now published


Released on 10th July 2020

This is the first beta release for Simple Commerce v2, the flat file version. Instead of using a database to store products, order etc, they are stored as normal collections and entries to make the developer experience more statamic-y.

There's still a few features needing built like Coupons and there's some stuff that needs cleaned up, like the shipping implementation but it's on the TODO list and I'll get it done in time for launch.

Oh... and I'm planning to launch in the next 1/2 weeks 😄

Just a quick note: if you're currently using the v1 beta for building a site, I'll continue supporting that for the time being and I'll release hotfixes as they're needed.