Shopify AssetLink user guide

The Shopify AssetLink app allows you to link product assets in your Cloudinary Media Library to your Shopify stores, attaching them to products based on metadata matching. This guide walks you through the process, from selecting assets to configuring the sync settings and running the synchronization.

Select assets and open AssetLink

The first step in using AssetLink is to select the assets you want to sync to your Shopify stores.

Search for the assets you want to link and select them

To select assets to sync:

1. In the Console, use the Product Navigation menu on the left:
   1. Select Assets to navigate to the Assets product.
   2. Select Assets under Media Library open the Advanced Search.
2. Use the free search textbox or the available filters to find the assets you want to sync.
3. Select up to 1000 assets.
   Tip

   To select all visible assets at once, use Command-A (⌘+A on Mac) or Ctrl+A (on Windows/Linux).

Open AssetLink

Once you've selected your assets, you can open them in the Shopify AssetLink app.

To open the AssetLink app:

• From the (3-dots) option menu in the assets toolbar, select Shopify AssetLink. This opens the AssetLink app in Cloudinary Assets dialog box, with the Setup with your selected assets.???Is this open by default for non-admins?

Review configuration and setup

???Can a user who's not master admin see this tab, just can't make changes? Or is it not available to them at all?

Administrators can configure the basic settings for your asset synchronization. They can set up your Shopify store connection, choose which metadata fields to use for grouping assets, and configure other essential settings. You can view those settings, but only admins for the Cloudinary account can make changes.

To review setup configuration:

Once you've selected assets and opened AssetLink, go to the Setup tab.

For more details about the tab, see Setup in the Shopify AssetLink Admin guide.

Link assets to Shopify products

The Link to Products tab is the main working area where you organize selected assets and configure how AssetLink links them to your Shopify products.

To open the Link to Products tab:

1. Select assets and open AssetLink.
2. Select the Link to Products tab.

Select stores to sync to

Select which stores you want to sync to. When you select a store, you can see the number of products matched by the assets in the selection.

Configure asset linking

Configure how AssetLink matches your Cloudinary assets to Shopify products and where it places them in product galleries.

Match assets to products

AssetLink groups your assets and matches them to Shopify products based on the metadata fields you select:

• Cloudinary Field: Choose which Cloudinary metadata field to use for grouping (e.g., SKU, product_id, etc.). AssetLink groups together all assets that share the same value in this field.
• Shopify Field: Select which Shopify field to match against the Cloudinary field. You can match against standard fields like SKU, title, tags, or custom metafields.

When a Cloudinary field value matches a Shopify field value, AssetLink links all assets in that group to that product. Here's an example showing assets grouped by product SKU:

Choose how to integrate with existing media

Determine how AssetLink integrates your assets with existing product media. Select one of the following options from the Link Mode dropdown:

• In-Place Overwrite: Updates assets at their current positions in the gallery. If a product has 5 images and you sync 3 matching images, AssetLink replaces the first 3 images while keeping the remaining 2 in place.
• Reset: Removes all existing product media and replaces it with only the assets you're syncing. Use this when you want the synced assets to be the only media for the product.
• Append: Adds the synced assets to the end of the existing media gallery. Existing assets remain unchanged and appear before the newly added assets.
• Prepend: Adds the synced assets to the beginning of the existing media gallery. Existing assets remain unchanged but appear after the newly added assets.
• Specific Position: Inserts the synced assets at a specific position you specify in the gallery, shifting existing assets as needed.

Set asset order

Control the sequence in which your synced assets appear relative to each other within a product's media gallery. You can set the order automatically based on metadata, or manually reorder assets.

Ordering options:

• Order by metadata field: Select a metadata field from Order product assets by... to automatically order assets within each group. For example, if you choose a field like sequence_number or priority, AssetLink arranges the assets based on those values.

  

• Manual override: Manually reorder assets by dragging and dropping them in one of the viewing modes or using the arrow controls next to each asset. This overrides any automatic ordering.

Review and manage assets

In the Link to Products tab below the Link Configuration you can see the assets you selected for sync:

Viewing modes

You can view your assets in two modes:

• Compact Mode: Shows assets in a condensed list format, ideal for quick overview and bulk operations

  

• Regular Mode: Displays assets in a detailed table format with thumbnails, metadata, and individual controls

  

Asset management features

Before syncing, you can make final adjustments to your assets. These features help you fine-tune which assets sync and how they appear:

• Asset Exclusion: Click on an asset thumbnail to exclude it from the sync, or click the (-) button next to a group to exclude the entire group
• Manual Reordering: Drag and drop assets to reorder them within groups
• Alt Text Management: Set custom alt text for each asset or use AI-generated alt text
• Asset Type Detection: AssetLink automatically detects and handles different asset types. Product images sync to the product media gallery, while swatches sync to Shopify files and the cloudinary.swatch metafield (swatches don't appear in the ordered product gallery).

Sync and monitor progress

After you configure your link settings and asset order, you can sync your assets to Shopify.

To start the sync:

1. Review your asset groups and configuration.
2. From the Link Configuration section, click the Link X assets in Y groups to Z products button to begin syncing assets to the selected Shopify stores.

   

   Tip

   Before you actually perform the sync, click Dry run to preview what the results will be.

AssetLink provides several features to help you monitor and manage the sync process:

• Progress Tracking: View real-time progress updates during sync operations
• Error Handling: Review detailed error reporting for any failed operations
• Abort Capability: Cancel sync operations in progress if needed
• Sync Reports: Download detailed reports of sync operations for your records

Upload assets to store files

The Upload to Store Files tab allows you to upload assets directly to your Shopify store's file library without linking them to specific products. This is useful for general assets like logos, banners, or other store-wide content that isn't associated with specific products.

To open the Upload to Store Files tab:

1. Select assets and open AssetLink.
2. Select the Upload to Store Files tab.

Use this option when products don't exist yet, or when you're uploading site-wide images and videos that don't belong to any particular product.