Last updated: Aug-12-2024
Migrating images to Cloudinary from Salesforce Commerce Cloud (SFCC) involves synchronizing existing images to ensure optimal delivery through Cloudinary. In SFCC, images are categorized into two regions: Product/Catalog (for PDP/PLP) and Content (general content like homepage and landing pages). This guide outlines best practices for migrating images.
Note
This guide demonstrates migrating Product images, but the process applies to non-products as well.
On this page:
How to migrate images from SFCC to Cloudinary
-
Configure the Initial Upload job in SFCC:
- Access the Business Manager of your Staging SFCC B2C environment.
- Navigate to Administration -> Jobs.
- Configure the Cloudinary - Initial upload of product assets job.
- Set the CLDJobExecutionMode to
Debug
. - Set CLDNumberOfAssets to 20, which is ideal for system checks.
-
Run the Initial Upload job:
- Execute the job and review the job log files for any errors.
- Verify in the Cloudinary Console that the assets have been uploaded correctly.
-
Run the full catalog synchronization:
- Change the CLDJobExecutionMode to Prod - backfills only.
- Run the job to synchronize the complete catalog (excluding any assets uploaded previously).
-
Handle common errors:
-
400
- Assets with trailing spaces. Remove trailing spaces from folders and filenames in SFCC. -
404
- Assets are missing. Verify if the missing images correspond to old SKUs and determine if they are still relevant. -
503
- Service Unavailable. This indicates rate-limiting by SFCC.
-
-
Re-run the job after fixing errors:
- After resolving the
400
and404
errors, run the job again. The log should now be as clean as possible.
- After resolving the
-
Set up the Delta Upload job:
- Configure the Cloudinary - Delta Upload catalog assets job.
- Set CLDJobExecutionMode to Prod to handle uploading new assets and overwriting existing ones.
- Schedule this job to run every 20 minutes.
By following these steps, you can ensure a smooth and efficient migration of media assets from SFCC to Cloudinary, optimizing image delivery and management.
✖️