TABLE OF CONTENTS

• Configuring an Azure Storage Server
• Configuring Image Settings (General Settings Tab)
• Media File Types Allowed
• Configuring the External Media Setting
• Configuring Product Images through External Media
• Associating images from multiple media sources through import 

Navigate to: DAM > Media Settings 

Admin can manage media storage, default images, and image auto-resize settings from this section.

Configuring an Azure Storage Server

Media can be stored using Azure servers after an Azure account has been created. 

To configure the Azure Storage Server, admin users can perform the following steps:

• The storage server is selected by default for Azure

• Enter the Storage Account Name, which corresponds to the Azure "Storage Account Name".

• Enter the Access Key, which corresponds to the Azure "Primary Access Key".

• Enter Container Name, which corresponds to the detail for "Container Name" in Azure.

• Enter the Storage URL, which corresponds to the Azure "Storage URL".

• Save progress via the "Save" button. The page reloads with action confirmation.

• Storage Server is now configured.

• Click on the “Sync Existing Data” button to sync the data.

• To make the changes live and visible to all users, you must publish the store with the new configuration. Execute the Publish command. This action will deploy the updated settings across the system.

• Once the publishing is complete, the new storage server should be fully integrated, and the changes will be displayed. You can now verify that the system is correctly using the new storage URL and that files are being stored and retrieved as expected.
  

Configuring Image Settings (General Settings Tab)

Admins can manage the Default Product Image and Auto Image Resize settings for all stores globally by changing the Default Image from this section.

Ex: PDP uses a Large Image, and the "Add to Cart" page uses a Small Thumbnail Image. 

Admins can change the image size settings and manually generate the images in the saved new sizes using the Generate Images button.

Note - Images uploaded to the DAM from anywhere in the application will automatically get generated in the required sizes, so that admin users do not have to manually generate the images every time a new image is uploaded. Therefore, Admins will only have to manually generate the images when image sizes are changed or when images are loaded for the first time.

Media File Types Allowed

The system-defined Media Attribute controls the types of files that can be imported. The following are the types of files supported by Znode:

Configuring the External Media Setting

Znode’s Digital Asset Management (DAM) system now supports integration with external media sources. This feature allows admins to configure an external base URL and define URL patterns for rendering images across the platform.

• Go to DAM > Media Settings in the Admin Console.

• Configure the server by adding the required details in the given fields. (Explained above)

• Below these fields, there is a toggle button for Enable External Media Source.

  • When Enable External Media Source is set to YES, a new tab called “External Media Settings” is displayed. This section allows admins to define how Znode should retrieve and render external images

• External Media Settings

  • External Base URL

    • This is a mandatory field where admins must provide the fully qualified base URL of the external media system. 

      • Example: http://mysite.com

    • No automatic validations are performed; the system does not verify the URL at this stage.

  • Product Image Size Configuration:

    • A dedicated section called “Product Image Size Configuration” allows admins to configure how external images will be rendered.

      • Available System Macros:

        • Macros are placeholders used to dynamically generate URLs for image rendering. The supported macros are:

          • #baseurl# → Refers to the External Base URL entered above.

          • #imagename# → Refers to the actual filename of the image.

        • These macros can be combined to align with the external system’s URL patterns.

          • Example:#baseurl#/imagenames?size=800xB00&type*jpg

      • Image Types and Recommended Sizes:

        • Znode supports multiple image types, each with recommended resolutions. These fields are displayed as non-editable, so admins know which sizes must be provided in their external media system. The supported types are:

          • Large Image

          • Medium Image

          • Small Image

          • Cross-Sell Image

          • Thumbnail Image

          • Small Thumbnail Image

        • Admins must ensure that the external media system has all required image sizes to maintain a consistent experience across product pages, grids, and promotions

      • URL Configuration:

        • This setting defines the URL structure Znode uses to retrieve images. Admins can use macros to dynamically generate paths.

Configuring Product Images through External Media

When the Enable External Media Source setting is enabled under DAM > Media Settings, admins can configure product images using external sources in addition to the existing DAM (internal) storage. This enhancement allows flexibility to pull media directly from external base URLs or full external paths.

• Steps to Configure Product Images from External Media

  • Go to PIM > Manage Products > Edit Product > Images.

  • Clicking on the Change Button/Image will open the Attach Media modal window.

  • This modal provides three options to attach media:

    • Browse from DAM

      • Click the “Browse From DAM” button to select media directly from the internal DAM media library.

      • This option continues to function the same way as before.

      • Media Source will be displayed as InternalMedia once the image is associated.

    • Add a Filename (External Base URL)

      • Enter only the filename in the text field (e.g., samplefile.jpg) or a relative path with filename (e.g., /foldername/samplefile.jpg).

      • The system will use the configured External Base URL from DAM > Media Settings and append this filename to build the complete path.

    • Add a Full URL

      • Enter a complete external path in the text field.

        • For example:https://www.sample.com/samplefile.jpg

      • On clicking Save, the system will attempt to pull the file from the given URL.
         

  • Once the media is associated, click Save & Close.

  • To make the product image(s) live, select Publish.

  • Multiple files can be associated by adding rows in the modal. Each file entry will be saved as a separate record.
    

• List of areas where the image can be added through external media settings, similarly to product images.

  • Stores & Reps

    • Sales Representatives

      • Path: Stores & Reps >> Sales Rep >> Manage Sales Rep >> General Settings >> Image

    • Store Locations

      • Path: Stores & Reps >> Manage Store >> Store Locator >> Image

  • PIM

    • Products

      • Path: PIM >> Manage Products >> Image

    • Categories

      • Path: PIM >> Manage Categories >> General Info >> Image

    • Brands

      • Path: PIM >> Manage Brand >> Brand Logo >> Image

  • CMS

    • Store Experience

      • Path: CMS >> Manage Store >> General Settings

      • Fields:

        • Website Logo >> Add Image

        • Favicon >> Add Image

    • Containers

      • Ad Space Container

        • Path: Manage Container >> Manage Variant

          • Fields: Ad Space 1 and Ad Space 2 >> Add Image

      • Homepage Promo

        • Path: Manage Container >> Manage Variant

          • Fields:

            • Promo Large Image and Promo Small Image >> Add Image

      • Add Container Template

        • Field: Preview Image >> Add Image

    • Banner Sliders

      • Path: Manage Sliders >> Manage Banners >> Image

    • Blogs and News

      • Path: Manage Blogs and News >> Add New >> Blog News Info >> Image

  • Znode Attributes (All Types)

    • Path: Manage Attributes >> Simple/Multi Select

      • Manage Swatch Images

        • Add Image

  • Image and File Type: Attributes

    • All the existing or new attributes (file or image) that allow admins to associate files with Znode entities.

Associating images from multiple media sources through import

Znode allows administrators to bulk associate product images, category images, brand logos, product highlight images, and swatch images through the import process using multiple source types. These sources may include internal storage, external base URLs, or complete external URLs. To support this functionality, additional CSV columns are provided for each image/file attribute, clearly indicating the location from which the system should retrieve the asset.

• To begin the import process, follow these steps:

  • Navigate to System Settings > Import.

  • Click on Add New.

  • Select the desired Locale ID.

  • Set the Import Type

  • Select an existing import template or create a new one

• CSV Changes for Media Source

  • For every image or file attribute, an additional column is added with the suffix _Source. This column specifies where the image should be loaded from.

  • Example: ProductImage now has ProductImage_Source, and GalleryImages has GalleryImages_Source.
    

• This applies to several types of imports:

  • Product Import

  • Category Import

  • Brand Import

  • Highlights Import (uses existing column HighlightImagePath)

  • Attribute Default Value Import (uses existing column SwatchImagePath)

• Accepted Values in the “_Source” Columns

  • InternalMedia → Images are loaded from Znode’s internal DAM.

    • If left blank, this is considered the default.

  • ExternalMedia → Images are loaded from the external base URL configured in settings.

    • Only the filename needs to be provided (e.g., sample.jpg).

  • FullURL → Images are loaded from a complete external path.

    • The full path must be entered (e.g., https://mysite.com/sample.jpg)

  • If any value other than these is used, the import will fail, and the error will be displayed in the import log.

• Rules and Best Practices

  • For InternalMedia, the filename should match what is configured in the media manager.

  • For ExternalMedia, only filenames are required since the base URL is already configured.

  • For FullURL, the complete image path must be included.

  • Leaving the ”_Source” column blank defaults to InternalMedia.