2026 Configured Commerce Mobile release notes
13 min
Subscribe to updates on this page using the notification and RSS feed options. Learn more about setting up the Mobile App.
Optimizely no longer publishes to app stores for clients. You are responsible for app publishing and can do so with the help of a partner or Expert Services. The Mobile App team has also provided tutorials to help you with publishing. See Commerce Flutter App on Optimizely Academy. Contact your Customer Success Manager if you need help with the initial setup.
November 9
Release: 5.4.1 (hotfix)
Enhancement
- Upgraded the SDK to Flutter 3.47.8 (Dart 3.13.7) to apply security updates in response to recent Google changes. Rebuild and republish your app with Flutter 3.47.8 or later so your users receive these updates.
October 28
Release: 5.4.0
Enhancements
- Upgraded the third-party Flutter packages used by the mobile app, including Firebase, Google Maps, go_router, the barcode scanner camera package, and biometric authentication. Partner forks must review the following:
- Android users upgrading from an app build that used flutter_secure_storage 9.x or 10.0.0-beta are signed out once. Users with biometric sign-in enabled must sign in with their password and turn biometric sign-in back on in Settings. Check your pubspec.lock to see which version your app uses.
- Android now uses CameraX for the barcode scanner camera.
- The Android manifest now removes the READ_EXTERNAL_STORAGE, WRITE_EXTERNAL_STORAGE, FOREGROUND_SERVICE, and FOREGROUND_SERVICE_LOCATION permissions, so you do not need a foreground-service declaration in Google Play Console.
- On Android, opening the app from a closed state by tapping a push notification is now recorded once instead of twice, so your reported eventNotificationClicked count may decrease.
- Improved Crashlytics reporting so that recorded Dart errors are no longer flagged as fatal crashes, and image-load failures are filtered correctly. Crash-free user metrics now reflect actual app crashes.
- Improved security.
Bug fixes
- Fixed the issue where the barcode scanner returned errors when you canceled a scan or denied camera permission. The scanner now shows a message that tells you to allow camera access in your device settings.
- Fixed the issue where canceling a Face ID or fingerprint prompt left the sign-in screen stuck in a loading state.
- Fixed the issue where Dealer Finder and current-location directions opened the wrong coordinates because latitude and longitude were passed in the wrong order.
- Fixed the issue where swiping back on iOS while navigating inside a tab closed the entire tab navigation stack instead of returning to the previous page.
October 01
Release: 5.3.0
Enhancements
- Added an Update button to wish list quantity fields so you can type an exact quantity and save it without using the stepper buttons.
- Added product badges to the mobile app product details screen, search results, and wish list, matching badges already shown on the web storefront.
Bug fix
- Fixed the issue where you couldn't save a new credit card when the billing address country didn't include states or provinces.
- Fixed the issue where checkout failed with a payment error when paying by credit card without saving it, on storefronts using the TokenEx payment iframe with the Adyen gateway.
August 28
Release: 5.2.0
Enhancements
- Upgraded the SDK to Flutter 3.44.8, which keeps partner forks on a supported toolchain. Swift Package Manager is now the default for iOS, with CocoaPods as a fallback. Partner forks must move to Java 17, Gradle 8.14.3, Android Gradle Plugin 8.11.1, and a minimum iOS deployment target of 15.5.
- Added a Save card information checkbox to mobile checkout, so shoppers choose whether to store a new card. Mobile checkout now honors the Enable Saved Credit Cards setting and hides the checkbox when it is off. See Manage saved credit cards for setup.
- Added Optimizely Data Platform (ODP) event tracking to the mobile app, so search relevance reflects mobile shopper behavior. The app now sends page view, product, and navigation events when the ODP integration is enabled. See User events sync for the event mapping.
Bug fix
- Fixed the issue where the Add Line Notes and Add Notes links ignored the app's configured brand color.
July 30
Development continues on Product V2 (5.1.0). Commerce Mobile SDK 4.14.0 is the final supported release for Product V1 (classic). As of July 30, 2027, 4.14.0 enters maintenance mode. Optimizely provides fixes for 4.14.0 only when a customer reports an issue and cannot upgrade to 5.1.0.
Release: 5.1.0 and 4.14.0
Enhancements
- Added adaptive Android app-icon support and an updated theming model to the Commerce Mobile SDK, letting customers bring their branded apps in line with current Android icon and theming standards. See Migrate the Android launcher icon to an adaptive icon.
Bug fixes
- Fixed the issue where the Checkout button was missing from a cart that contained both regular and quote-required products, so shoppers could not check out the regular items.
- Fixed the issue where a product with a price of zero could be added to the cart from a list without the expected warning.
- Fixed the issue where the mobile app failed to send the ecommerce_purchase event to Firebase and Google Analytics, leaving purchase revenue untracked.
Release: 5.1.0 (only)
Enhancement
- Added Line Item Notes to the Commerce Mobile app so B2B buyers can view, add, edit, and delete per-line notes across lists, cart, checkout, and order history matching the web experience. See Add order and order line notes.
July 6
Release: 5.0.0
Enhancements
- Released Product V2 API support in the Configured Commerce mobile SDK. Product data and search now use the same V2 endpoints as the Spire storefront. Shoppers see search results that match the website, including on sites that use Commerce Search v3. Product search on the Quick Order page now returns results correctly. Product v1 and Product v2 are now on separate release lines, so Classic customers on Product v1 are unaffected.
Bug fixes
- Fixed the issue where product search returned no results on the Quick Order page when the site used Commerce Search v3.
- Fixed the issue where the mobile SDK returned different search results than the website when the site used Commerce Search v3.
July 2
Release: 4.13.0
Enhancements
- Added a required password-change step to mobile app sign-in, so users required to reset their password can set a new one and sign in instead of being blocked.
Bug fixes
- Fixed the issue where scanned barcodes could appear misaligned with uneven spacing in the Search History list. The list now truncates long entries with an ellipsis (…) instead of wrapping them, so items stay aligned.
- Fixed the issue where the product title overflowed the edge of the screen on the product details page.
June 15
Release: 4.12.1
Bug fix
- Fixed the Google Play rejection issue by removing the READ_MEDIA_IMAGES and READ_MEDIA_VIDEO permissions.
June 9
Release: 4.12.0
Bug fixes
- Fixed the issue where adding the same product to a list with a different unit of measure increased the quantity of the existing line item instead of creating a separate entry.
- Fixed the issue where the mobile app displayed the savings amount and savings percentage even when Show Savings Amount and Show Savings Percentage were disabled in the Admin Console, and where a zero savings value was shown.
- Fixed the issue where the mobile app displayed the Add Discount option in the checkout flow even when it was disabled in the CMS.
- Fixed the issue where delivery (Ship) checkout could not be completed because the Continue button on the checkout screen had no effect.
May 5
Release: 4.11.0
Enhancements
- Added a confirmation dialog when removing an item from a list on the List Detail screen. This matches the web storefront and protects against accidental deletion.
- Added a loading state to the Add to Cart button on the List Detail screen. The button now shows immediate feedback and prevents duplicate taps while the cart request completes.
Bug fixes
- Fixed the issue where the State field was not marked as required when adding a new address.
- Fixed the issue where the mobile app's Invoice History page did not display all of a customer's invoices.
- Fixed the issue where searching Customer or Ship To by full state name did not match records stored with the state abbreviation. Fixed a related issue where numeric searches returned unexpected results because the search matched against zip codes that were not shown in the list.
March 31
Release: 4.10.0
Bug fixes
- Fixed the issue where product specifications were not displayed on child products in the app, despite being visible on the web.
- Fixed the issue where incorrect date fields were displayed on the checkout screen based on the selected fulfillment option (ship or pick up).
March 11
Release: 4.9.0
Important
The minimum supported Android version has been updated from Android 6.0 (API level 23) to Android 7.0 (API level 24).
Bug fixes
- Fixed the authentication issue that caused a sign-in/sign-out loop on Android 16 devices running mobile app versions later than v4.3.0.
- Fixed the continuous loader issue that occurred when selecting a location from search results in the mobile app.
January 27
Release: 4.8.0
Enhancement
- Added the ability to change languages. When a language is selected (such as French), the mobile app will only display the menu items localized for that language.
Bug fixes
- Fixed an issue where a blank screen displayed on Android when you opened Print on the Order Details page.
- Fixed a document view Issue on Android from the Product Details page.