A critical vulnerability was discovered in React Server Components (Next.js). Our systems remain protected but we advise to update packages to newest version. Learn More

Quan Mai
Mar 22, 2019
  4820
(10 votes)

Commerce 13 is ready to go

The day has finally come, and we got the approval from our QA team for Commerce 13. It will be released to public earlier next week.

If you plan to upgrade to Commerce 13 (which you should ;) ), these are a few things to keep in mind

  • Commerce 13 is a breaking change release, which means you will most likely have to update your code for it to get it compiled. If you are using a more recent version of Commerce and if you are using the up-to-date features, you will have less things to worry about, and vice versa, so that's important to plan ahead.
  • The most signficant breaking changes in Commerce 13 are the removal of old promotion system, and old APIs like Entry, Node, and CartHelper, which we talked in details here https://world.episerver.com/blogs/Quan-Mai/Dates/2018/12/planned-breaking-changes-for-commerce-in-2019/. We urge you to switch to newer system/APIs  because they are not only the way forward, they are also better in many aspects (if not "any aspects")
  • We also take this change to introduce new features that would require breaking changes: new extendable OrderStatus and OrderShipmentStatus , a new API to get the parent order group from its component (orderforms, shipments or lineitems), or a new APIs to calculate taxes in batch of line items instead of one by one. 
  • Commerce 13 also contains some non breaking changes new feature, including per-promotion catalog item exclusion and managing shipping addresses in CSR UI.

A full list of changes in Commerce 13 can be seen here https://world.episerver.com/documentation/upgrading/episerver-commerce/commerce-13/breaking-changes-commerce-13/ .

Commerce 13 contains a small migration step, which should complete within seconds, so data migration should not be of your concern. You are welcome to test it when it's released and get back to us if you need further assistance.

A new version of ServiceAPI, FindCommerce and Avatax which support Commerce 13 will be quick to follow.

Mar 22, 2019

Comments

Mar 24, 2019 12:49 AM

Hey Quan, we are currently building a new site on Commerce 12.15.1 and are a couple months away from Production.

My questions are;

  1. How Production ready is will Commerce 13 be? eg. is this a CTP or RTM release?
  2. Would you recommend immediately upgrading to Commerce 13?
  3. Will there be a new Commerce 13 exam soon?

Cheers, Darren.

Mar 24, 2019 03:49 PM

Hi Darren, I clean up your comments. Regarding your question:

  1. Anything that is publicly released should be production ready. We did our best to ensure everything works as they should.
  2. Yes, at least for testing purpose, to assert how much time you would need to spend on the upgrade. If you are using, for example, old promotion system then it should be easier to migrate to the new system then migrate. If you are using FindCommerce and/or ServiceAPI, you should wait for a little bit more. 
  3. I don't know, I would expect there will be but it would take time to have more features worth testing for.

sheider
sheider Nov 1, 2019 08:23 PM

PART 1

"Commerce 13 contains a small migration step, which should complete within seconds, so data migration should not be of your concern. You are welcome to test it when it's released and get back to us if you need further assistance."

Hey Quan, we are having an issue with this migration step for serializableCarts. Could you spare some details on the migration step and what changes occurred to the serializable cart? It seems that the custom metadata properties now are no longer inferred by type but have a type and value. Example:

//OLD CART Metadata Property
"CWDTaxTotal": 6.71


//POST UPGRADE CART Meta Data Property
"CWDTaxTotal": {
    "$type": "System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
    "$value": 0
}

As you can see the type isn't even correctly set. Any information on what was changed and how we can successfully migrate the pre upgrade carts would be appreciated.

PART 2

To make progress with other parts of the upgrade we deleted the serializable carts. 

However there is an issue with serializable carts themselves. The ParentOrderGroup property on the ICart and IShipment are causing a circular reference error when using the json converter. This is preventing us from being able to view carts via ajax calls. Any suggestions to get

Please login to comment.
Latest blogs
A day in the life of an Optimizely OMVP - Optimizely Opal: Specialized Agents, Workflows, and Tools Explained

The AI landscape in digital experience platforms has shifted dramatically. At Opticon 2025, Optimizely unveiled the next evolution of Optimizely Op...

Graham Carr | Dec 16, 2025

Optimizely CMS - Learning by Doing: EP09 - Create Hero, Breadcrumb's and Integrate SEO : Demo

  Episode 9  is Live!! The latest installment of my  Learning by Doing: Build Series  on  Optimizely Episode 9 CMS 12  is now available on YouTube!...

Ratish | Dec 15, 2025 |

Building simple Opal tools for product search and content creation

Optimizely Opal tools make it easy for AI agents to call your APIs – in this post we’ll build a small ASP.NET host that exposes two of them: one fo...

Pär Wissmark | Dec 13, 2025 |

CMS Audiences - check all usage

Sometimes you want to check if an Audience from your CMS (former Visitor Group) has been used by which page(and which version of that page) Then yo...

Tuan Anh Hoang | Dec 12, 2025

Data Imports in Optimizely: Part 2 - Query data efficiently

One of the more time consuming parts of an import is looking up data to update. Naively, it is possible to use the PageCriteriaQueryService to quer...

Matt FitzGerald-Chamberlain | Dec 11, 2025 |

Beginner's Guide for Optimizely Backend Developers

Developing with Optimizely (formerly Episerver) requires more than just technical know‑how. It’s about respecting the editor’s perspective, ensurin...

MilosR | Dec 10, 2025