Saleor 2.10 Release: multi-warehouse, permission groups, new checkout, and new docs

Welcome everyone to Saleor 2.10! It’s been six months since we had our last major release. During this time, we’ve been working on creating new key features, fixing bugs and removing barriers essential to the user experience.

So let’s summarize what the new update brings to the platform:

• Multi-warehouse inventory
• Permission groups
• New storefront checkout with Improved performance
• New documentation

---

Saleor multi-warehouse

We have had a multi-warehouse feature on our radar for a long time. In short, it gives you the ability to split inventory among multiple locations. Since many of our users mentioned it, we decided to make it a priority.

You can assign multiple warehouses to only one shipping zone for now. If you set a shipping zone for only one country, then you can manage multiple warehouses there.

How does it work? The whole stock management process is handled in the dashboard. So, you just log in to the dashboard, go to configuration and there you’ll find a section called ‘Warehouses’. You will be able to manage the whole process from there. You can find more information and watch a video about Saleor warehouses here

An example of multi-warehouse inventory

Permission groups

From now on you can create groups of staff members with similar access permissions to your store. It will help you easily maintain permissions in your organization.

When you invite someone to manage the store, you will choose a specific permission group for that person. A staff member can be assigned to multiple groups with different permissions.

The feature is available in the configuration settings.

An example of permission proup

New storefront checkout and improved performance

We have carried out several fixes and provided improvements to the storefront which have had a significant impact on its performance—you can find all changes here.

The new release adds stateful checkout and cart to the SDK. The logic for handling cart and checkout was previously distributed across many React components. This, as we had observed, made it difficult to understand and also complicated creating your own checkout and cart-related UI.

From now on, you only need to use SaleorProvider. It can deliver the whole cart and checkout maintenance through hooks.

<SaleorProvider client={apolloClient} config={optionalCustomConfig}>
  {/* use Saleor hooks anywhere in the components tree */}
</SaleorProvider>

const {
 checkout,
 billingAsShipping,
 selectedShippingAddressId,
 selectedBillingAddressId,
 availableShippingMethods,
 payment,
 availablePaymentGateways,
 promoCodeDiscount,
 loaded,
 load,
 setShippingAddress,
 setBillingAddress,
 setBillingAsShippingAddress,
 setShippingMethod,
 addPromoCode,
 removePromoCode,
 createPayment,
 completeCheckout,
} = useCheckout();
const {
 items,
 discount,
 shippingPrice,
 subtotalPrice,
 totalPrice,
 loaded,
 load,
 addItem,
 subtractItem,
 updateItem,
 removeItem
} = useCart();

If you prefer not to use React, you can still use SaleorManager instead. This delivers the same checkout and cart logic as SaleorProvider:

const manager = new SaleorManager(apolloClient, optionalCustomConfig);
manager.connect(saleorAPI => /* use methods from Saleor API */)

const { 
 checkout, 
 billingAsShipping, 
 …restCheckoutStateAndMethods 
} = saleorAPI.checkout;
const { 
 items, 
 discount, 
 …restCartStateAndMethods 
} = saleorAPI.cart;

In addition to the SDK, we have prepared a new UI. It is presently using new hooks.

A new checkout

New documentation

Together with the release of Saleor 2.10, you’ll find new documentation with the aim of lowering the entry level for Saleor users. Additionally, alongside the docs, we are working on an FAQ section to be added soon.

To make your life even easier, we’ve created a splash screen that appears when you run a Saleor instance locally.

---

Thank you!

As always a big thank you 🙏 to all our contributors and supporters! If you have any questions or feedback, feel free to reach us on Spectrum or Twitter.

---

Related Articles:

• Saleor Multi-Warehouse Inventory
• Saleor 2.9.0
• A Return to the Release Cycle and a Glimpse into the Future