Skip to content
  • There are no suggestions because the search field is empty.

Shopify Setup - Sending Listing Images to Platform

You can send images for CSM Listings to Shopify to attach to products and variants. 

You can both upload a graphical file or reference a hosted URL path to attach an image to a Shopify Listing for display on your Shopify store. Both options end the same way: the image is created as a file asset in Shopify and attached to the product. You can also mix both options on the same Listing.

Option Use when Requirement

Option 1:

Upload a file

 The image lives in Business Central (or on your computer) and isn't hosted anywhere public. A Media Upload record containing the image file

Option 2:

Reference a URL

 The image is already hosted somewhere Shopify can reach it — a CDN, an S3 bucket, your own site, a DAM. The external image URL

 

Option 1: Upload a file

  • On the CSM Listing card for the related product, choose Add Image.
    • This creates a CSM Product Information record with Information Type = Image.
  • Open the record and set Source Type = Media Upload.
  • Link the record to a Media Upload record containing the image file, and enter a Name.
  • Back on the CSM Listing card, choose Actions > Send to Channel > Product Information > Images.
  • Confirm the External ID field on the Product Information record is populated.
    • This is the Shopify file GID and means Shopify accepted the image.
  • Open the product on your Shopify admin site and confirm the image is attached.

For this particular option, CSM makes three calls to Shopify:

  1. Requests a Staged Upload URL
  2. Uploads the file to that URL
  3. Creates the file asset in your Shopify store

Note: Linking to a Media Upload is not limited to products. You can use it to upload an image to Shopify's file library without attaching it to a specific product.

 

Option 2: Reference a URL

Instead of uploading a file, you can type in an external image URL and let Shopify fetch it.

  • On the CSM Listing card, choose Add Image.
    • This creates a CSM Product Information record with Information Type = Image.
  • Open the record and set Source Type = URL.
  • Enter the image URL in Value, then enter a Name.
  • Back on the CSM Listing card, choose Actions > Send to Channel > Product Information > Images.
  • Confirm the External ID field on the Product Information record is populated.
    • This is the Shopify file GID and means Shopify accepted the URL.
  • Open the product in Shopify admin and confirm the image is attached.

Note: Shopify downloads external URLs asynchronously, so the image may take a few seconds to appear on the product even after the action completes successfully. Refresh the product page in Shopify admin if it isn't there right away.

Caution: 

  • The URL must be publicly reachable. Ensure there is no login, expired signed-URL, or IP allow-list in the way. If Shopify can't fetch it, the image won't attach.
  • Point at the image file itself (a URL ending in .jpg, .png, .webp, etc.), not at a web page containing the image.
  • Use https in your URL path.
  • The image must meet Shopify's own file size and dimension limits.

 

Troubleshooting

  • The action completed but External ID is blank

    • Shopify rejected the image. For Option 2, the most common cause is a URL Shopify couldn't reach. Test it in a private/incognito browser window to confirm it loads without credentials.

  • The image never appears in Shopify admin

    • For Option 2, wait and refresh first. If it still doesn't appear after a minute, check the URL requirements above. This has been observed to take up to a minute to fully process.

  • Error about a null file id

    • This indicates the image was not successfully created in Shopify before CSM tried to attach it to the product. Confirm the record has a valid Media Upload (Option 1) or a reachable URL (Option 2), then send again.