More Products

commercetools extension operational overview

Last updated: Mar-17-2024

Once the extension is set up, you can manage the content you display on your commercetools site via the Cloudinary DAM. You can:

Note
The structured metadata field names that appear in these instructions are just examples and may differ from the ones you see in your product environment.

Add Cloudinary assets to a new commercetools Product

When you create a new Product in commercetools, you'll want to link Cloudinary images to it.

First, look up the new Product's SKU and keep the number accessible. Then, follow these steps in the Cloudinary DAM:

  1. Upload the assets for the new Product to the Cloudinary DAM.
    • Switch to the Folders view using the tab at the top of the Media Library and navigate to, or add, the desired folder.
    • Drag and drop the assets into the folder.
      Note
      You can also keep track of your assets by using tags.
  2. Configure List view:
    1. Switch to List view by clicking the View icon.
      Switch to List view
    2. Click the Settings icon to select the columns you want to display.
      Display selected columns
      Note
      These settings are saved, so you only have to set this once for each page of the Media Library.
  3. Select all the assets you want to link to the new Product.
  4. From the asset toolbar, select Edit Structured Metadata to set the metadata for all selected assets.
    Select assets
  5. The following dialog box opens showing all the structured metadata fields that are set up in your product environment:
    Note
    Your product environment may contain additional fields to the ones shown here. However, it must contain fields similar to commercetools SKU and commercetools publish, possibly with somewhat different names.
    Bulk update metadata You can select any field you want and update its value. The new value will be applied to all the assets you selected.
    • To link the assets to a Product, select the commercetools SKU field and enter the SKU of the commercetools Product you want to link the assets to.
    • If you want to publish or stage the assets, set the commercetools publish field to cl_ct_publish or cl_ct_draft.
    • Optionally change any other structured metadata fields that you want to set for all selected assets and click Update.
  6. Set the position on the PDP individually for each asset by clicking the asset to open the Manage page.

    Click the Metadata tab, expand the Structured metadata section, and specify the desired value for the Sorting number.
    Set Sorting number

Update Cloudinary asset links to Products

You can update which Product a Cloudinary asset is linked to. You can do this for multiple assets at a time, or for individual assets.

First, look up the SKU of the Product that you want to link your assets to and keep the number accessible. Then, follow these steps in the Cloudinary DAM.

Update assets in bulk

  1. Switch to the Assets page using the tab at the top of the Media Library.
  2. Use the Folders filter to find the assets you want to update by their containing folder.
    Note
    If you use tags to keep track of your assets, you can use the Tags filter.
  3. Configure List view:
    1. Switch to List view by clicking the View icon.
      Switch to List view
    2. Click the Settings icon to select the columns you want to display.
      Display selected columns
      Note
      These settings are saved, so you only have to set this for each page of the Media Library.
  4. Select all the assets you want to update.
  5. From the asset toolbar, select Edit Structured Metadata to update the metadata for all selected assets.
    Select assets
  6. The following dialog box opens showing all the structured metadata fields that are set up in your product environment:
    Note
    Your product environment may contain additional fields to the ones shown here. However, it must contain fields similar to commercetools SKU and commercetools publish, possibly with somewhat different names.
    Bulk update metadata You can select any field you want and update its value. The new value will be applied to all the assets you selected.
    • To update the Product link, select the commercetools SKU field and enter the SKU of the commercetools Product you want to link the assets to.
    • To publish the assets, set the commercetools publish field to cl_ct_publish.
    • To unpublish the assets, set the commercetools publish field to cl_ct_unpublish.
    • To stage the assets (advanced feature), set the commercetools publish field to cl_ct_draft.
    • Optionally change any other structured metadata fields that you want to set for all selected assets and click Update.

Update assets individually

To update an individual asset's link to a Product, click the asset to open the Manage page, select the Metadata tab, expand the Structured metadata section, and specify the SKU of the Product you want to link to.

Update commercetools SKU

Publish assets

Once your assets are approved and ready, you can publish them to commercetools. They'll then be automatically displayed on your app or website according to the Product that they're linked to. The assets will also appear on the Variations > Images page of the Merchant Center.

Note
The commercetools extension provides one-way synchronization from Cloudinary to commercetools, and changes that you make to assets in the Merchant Center won't be updated on Cloudinary.

To publish assets in bulk, follow these steps.

To publish an individual asset, click the asset to open the Manage page, select the Metadata tab, expand the Structured metadata section, and set the commercetools publish field to cl_ct_publish.

Unpublish assets

If you want to take assets off production, you can do so by unpublishing them.

To unpublish assets in bulk, follow these steps.

To unpublish an individual asset, click the asset to open the Manage page, select the Metadata tab, expand the Structured metadata section, and set the commercetools publish field to cl_ct_unpublish.

Stage assets - advanced feature

If you want to stage assets linked to a Product but not have them appear in production, you can set the assets as drafts. The assets will then appear on the Variations > Images page of the Merchant Center.

To stage assets in bulk, follow these steps.

To stage an individual asset, click the asset to open the Manage page, select the Metadata tab, expand the Structured metadata section, and set the commercetools publish field to cl_ct_draft.

Note
Some considerations when staging your assets:
  • If your assets are already published and you want to move them to staging, you must first unpublish the assets and then stage them, otherwise they'll will remain in production.
  • The commercetools extension provides one-way synchronization from Cloudinary to commercetools, and changes that you make to assets in the Merchant Center won't be updated on Cloudinary.

Set or update an asset's position on the PDP

You can determine the order that your Product assets appear on the PDP.

  • Set the position on the PDP individually for each asset by clicking the asset to open the Manage page, clicking the Metadata tab, expanding the Structured metadata section, and specifying the desired Sorting number.

    Set Sorting number

Set or update alt-text and description

You can set the alt-text of the commercetools Product Asset via Cloudinary.

  1. Click the asset to open the Manage page, click the Metadata tab, and expand the Contextual metadata section. Set alt-text and description
  2. Enter a value for the Title (caption) contextual metadata field. The Product Asset alt-text in commercetools will be updated to the new value when you publish the asset.

✔️ Feedback sent!

Rate this page: