Skip to content

CSM-Shopify Release Notes - 5.0.2026042428.274165

CSM For Shopify 5.0.2026042428.274165

May 21, 2026

Overview

Version 5.0 is the largest update to CSM for Shopify since the product launched! 

The biggest change under the hood is that Product Listing Management (syncing products, images, availability, and configurable items) has been rebuilt on Shopify's modern GraphQL API. This keeps CSM aligned with Shopify's long-term API roadmap and enables capabilities that were not possible before, like per-variant image assignment and direct control over product status and visibility.

On top of that, v5.0 adds full B2B Automation for company and contact sync, a new Media Upload Tool for product images and video, a complete end-to-end Refund Workflow, and a redesigned Setup Wizard that now supports adding additional stores (new store connections now use Shopify's secure OAuth 2.0 sign-in instead of manual credential entry).

 

Added

Modern Product Listing Management

Product sync (including creation, availability, images, and configurable parent/child variant listings) now runs on Shopify's GraphQL API, Shopify's current recommended integration layer. The GraphQL listing layer is available for new Shopify store connections set up through the v5.0 wizard. Existing implementations continue to operate as configured.
  • What this means for you:

    • Product status, visibility, descriptions, and category are now sent correctly when a listing is created or updated
    • Per-variant image assignment is fully functional: images are attached to the configurable parent product first, then linked to specific variants as Shopify requires
    • A new External SKU field on the Listing record captures the Shopify-assigned SKU when products and variants are retrieved, giving you a reliable cross-reference between Business Central and Shopify

 

Product Image and Video Upload

You can now stage and send product images and videos to Shopify directly from the CSM Product Information card in Business Central.

  • What this means for you:

    • Upload images and videos to Shopify without leaving Business Central
    • Supported file types (images and videos) are detected automatically, so there is no need to manually set the content type
    • A new Media Upload list shows all staged media entries per store, with file name, alt text, and upload status
    • An image preview panel on the Product Information card lets you review media before sending

 

Improved Order Retrieval

Order headers and order line items are now retrieved in two separate steps instead of one combined call.

  • What this means for you:

    • Faster order header sync for high-volume stores, as headers no longer wait for line item data
    • When you retrieve a single order, the system automatically fetches the order lines and refund data in sequence, then marks the order as New and ready for processing, all in one pass
    • Order status moves from Incomplete to New only after all lines have been successfully retrieved, giving you a clear indicator that the order is complete

 

B2B Automation Jobs

New scheduled automation jobs keep your Shopify B2B data in sync with Business Central automatically.

  • What is included:

    • Retrieve Contact Roles retrieves company contact role assignments from Shopify and updates Business Central records
    • Send Main Contact pushes your designated primary contact to a Shopify company

Both automations run per store, so each store in a multi-store setup has its own independent automation schedule.

 

B2B Contact Role Reassignment

You can now revoke an existing contact role and assign a new one in a single operation, instead of having to remove and re-add separately.

 

Automatic B2B Location Classification

When company locations are imported from Shopify, CSM now automatically classifies them. This matches the standard Business Central customer/ship-to model and eliminates the need to manually set location types after import.

  • What this means for you:

    • The oldest location (by creation date in Shopify) is set as the Customer location
    • All other locations are set as Ship-To locations

 

 
 

Redesigned Setup Wizard

The Shopify Setup Wizard has been rebuilt from the ground up.

  • What is new:

    • Quick Setup is a streamlined path that takes new users from store name entry through OAuth browser-based sign-in to a fully configured sales channel in a few steps*
        • What this means for you:
            • Connecting a new store is faster and more secure: click Connect to Shopify, sign in via browser, and you are done.
            • Administrators can connect or disconnect a store at any time from the Sales Channel card using the Connect to Shopify and Disconnect from Shopify actions, without going through the Setup Wizard
            • Disconnecting a store fully removes stored credentials
            • Existing stores using API key (Basic) authentication are unaffected. No changes are required.
    • Custom Setup provides full control over every option, for advanced configurations
    • Add a second store lets you connect an additional store to an existing API Engine setup without duplicating shared configuration
    • The Next button is disabled if required setup fields are incomplete, preventing you from moving forward on a partial configuration
    • Step descriptions have been rewritten for clarity throughout
*Note: As of this version release, the framework for the new Quick Setup Wizard is built but browser-based sign-in is not yet fully functional. Until this feature is finished, new setups can follow instructions in our Shopify Setup - Quick Setup Wizard.
 

 Updated

  • Shopify API Version: 2026-01

    • All store connections are now configured to use Shopify's latest supported version. Existing installations are migrated to the new version automatically on upgrade, so no manual changes are needed.

  • API Engine Library Version: 1.21.0.0

    • The new API Engine capabilities are what enable several of the features in this release.

    • API function naming has been standardized and legacy data structures from earlier versions have been removed. These are internal changes only and no functional behavior has changed for end users.

    • API administrative extensions in Business Central have been renamed. Previous naming convention had "CSM" as a prefix for all extension names and the new API Engine has "CSM" removed - examples:
      • CSM API Sets is now API Sets
      • CSM API Message is now API Messages

 

Fixed

  • Refund shipping amounts sent as zero

    • Issue: When creating a refund that included a shipping charge, the shipping amount was always sent to Shopify as $0.

    • Fix: Shipping amounts are now correctly included in all refund submissions.

  • Multi-store: order line automation registered to the wrong store 

    • Issue: The automation for retrieving order lines contained a hard-coded store reference, causing it to be registered against a fixed store regardless of which store was being configured.

    • Fix: The store reference is now set dynamically during setup, so each store gets its own correctly assigned automation.

  • Date filter returning unexpected order results

    • Issue: The “last modified” date filter used when retrieving orders was generating an incorrectly formatted timestamp, causing the filter to return unexpected results.

    • Fix: The timestamp format has been corrected.