9 Manage Media for Your Store

You can upload and manage product and collection images, as well as media that you use in other places on your store, such as a hero image on the home page. Retail Digital Commerce automatically sizes your images for display on different devices, such as laptops, tablets, and mobile phones.

This section describes how to use the Media tab to upload and manage images that appear on your store.

View the Media Library

Click the Media icon to see all the files in your media library displayed in a grid.

Media files are initially sorted by name, though you can also sort them by size or last-modified date. You can also display them in a list.

The media library stores files in the following folders:

  • Products - contains media files assigned to and available to products.
  • Collections - contains media files assigned to and available to collections.
  • General contains media files you can access when you configure the design elements for your store. See Design Your Store Layout for more information.

Click Products, Collections, or General to view and access just that folder’s media files and to upload the selected types of files. Click All Media to view and access all files in your media library. You cannot move media files from one folder to another.

Click an image to display details for that file, including name, path, size, file type, and the date and time it was last modified.

There is a unique URL for each published item in your media library, providing a direct link that lets you open the item in a browser. Format the URL as follows:

<store-base-url>/file/<path>

  • <store-base-url> is the URL Oracle provides to access your store.
  • <path> is the value of the Path field, which you can see when you click the image on the Media page.

For example, suppose the file oled4kwarranty.pdf contains a warranty for a TV sold on your store www.example2.com. The file is stored in the General folder. Use the following URL to access the PDF:

www.example2.com/file/general/oled4kwarranty.pdf

Upload Media Files

You can upload individual files to the media library or you can compress media files in a ZIP file, which you then upload to Retail Digital Commerce.

You can name media files so they are automatically assigned to products or collections in your catalog.

This section includes the following topics:

Automatically Assign Images to Products and Collections

You can format image-file names so that they are automatically are assigned to products and collections in your catalog when you upload them.

Format file names for product and collection images as follows:

<product_id>.<name>.<file_type>

<collection_id>.<name>.file_type>

  • <product_id> is the product’s Product ID property. See Create and work with products for more information.
  • <collection_id> is the collection’s Collection ID property. See Create collections for more information.
  • <name> is the descriptive name portion of the file.
  • <file_type> is the file extension. Only JPG/JPEG, PNG, and GIF files can be automatically assigned to products and collections.

For example, suppose you want to assign several images to a pair of boots whose product ID is xprod2102. You could upload the following files:

xprod2102.bootsideview.png
xprod2102ridingboottopview.png
xprod2102.ridingbootfrontview.png

Keep the following in mind when you name media files to upload:

  • A file cannot be assigned to a product or collection if a file of the same name is already assigned to it.
  • The file name is case-sensitive. For example, the system considers xprod030.rattanchair.jpg and xprod030.Rattanchair.jpg to be two different files.

Product IDs are case sensitive. xprod030 and XPROD030 are different product IDs.

You can also import assignments in bulk for images that you have already uploaded. See Import image assignments for more information.

Upload Individual Images

You can upload individual JPG/JPEG, PNG, and GIF files to the media library. You can name media files so they are automatically assigned to products or collections in your catalog once they are uploaded. See Automatically assign images to products and collections for more information.

To upload a single image:

  1. On the Media page, select the type of media files to upload. Select Products, Collections, or General.
  2. Click Upload.
  3. Select an image to upload.

    You can upload only one image at a time. To upload multiple images at once, see Upload multiple media files.

    If you select a file with the same name as a file you already uploaded, the new file replaces the existing one.

  4. Click Save.

Upload Multiple Media Files

To upload a number of media files at once, compress them in a ZIP file, then upload the ZIP file to the media library. Retail Digital Commerce scans the ZIP file for viruses and checks to ensure it contains only allowed file types. (You can upload only GIF, JPG/JPEG, PNG, SVG, and PDF files.) You can name media files so they are automatically assigned to products or collections in your catalog once they are uploaded. See Automatically assign images to products and collections for more information.

Note:

Each ZIP file cannot be larger than 1GB. If your upload times out, check the ZIP file to make sure its size is 1GB or smaller.

To upload the ZIP file:

  1. On the Media page, select the type of media files to upload. Select Products, Collections, or General.
  2. Click Upload.
  3. Find the ZIP file to upload and click Open.

    Depending on the size of the ZIP file, this process could take some time to complete. Remember that the ZIP file you upload must not be larger than 1GB.

    When the upload is complete, the Upload Media dialog displays the total number of new and changed files, errors, and files assigned to products or collections. To see a complete report for the upload in CSV format, click Download Full Report.

    If you upload a file with the same name as a file you already uploaded, the new file replaces the existing one.

Edit and Remove Media Files

You can change a media file’s name or remove it from the media library.

This section includes the following topics:

Rename Media Files

You can rename a file in the media library. If the file is an image assigned to a product or collection, renaming it breaks the connection to the product or collection. Once you save the new name, however, the service checks the name and if the name is formatted correctly, automatically assigns the image. See Automatically assign images to products and collections for more information.

To rename a media file:

  1. On the Media page, find the file you want to rename and click.
  2. Enter a new name in the Name box.

    Do not use the same name as an existing file in the same folder.

  3. Click Save.

Remove Media Files

When you remove a file from the media library, you cannot access it again with the Retail Digital Commerce tools. If you remove the primary image for a product or collection, the next image assigned to it becomes the primary image. If you remove all images from a product, a placeholder is displayed on your store.

To remove a file from the media library:

  1. On the Media page, navigate to the files you want to remove.
  2. Hover over a file and click the X icon when it appears.

    To remove multiple files, hover over a file and click the check mark icon when it appears. (To remove all the files on the current page, click Select All.) Repeat this for all the files you want to remove and then click the X icon on any of them.

  3. Confirm that you want to remove the selected files.

Import Image Assignments

You can use the Retail Digital Commerce import process to assign a number of already-uploaded images to products and collections at once and to create a title and alt text for each assigned image.

See Import and Export Catalog Items and Inventory for details about how to import and export data in Retail Digital Commerce.

The easiest way to format a file for importing image assignments for products or collections is to start by exporting a file that you can use as a template for the items you want to add or modify. See Export catalog items for more information about how to export.

When you look at the exported spreadsheet, you can see that the second row displays column headings that contain the internal names of the exported properties. There are three properties for image assignment:

  • images specifies the name and path of the uploaded image to assign to the product or collection)
  • altText specifies the alt text to assign to the image.
  • title specifies the title to assign to the image.

Product or collection data begins in the third row and continues for the remainder of the spreadsheet. If an item does not have a value for a property, the corresponding cell is blank. When you enter data in the images column, you must format it as follows:

media<number>:<path>/<file_name>

  • <number> is the number that specifies the display order of the image. media1 specifies that the file will be displayed as the primary image.
  • <path>/<file_name> specifies the full path to the image and the name of the image file, including the extension. The path and file name for an image is shown in the Path field on its details page, which you access from the Media page. See View the media library for more information.

Note:

When you import multiple image assignments for a product or collection, you separate them with a | (vertical bar). Therefore, you should not use this character in any media file names.

See Import catalog items and inventory for more information about how to import your changes back into the catalog.