Skip to content

From version 3.8.3

This page describes behaviour available from client version 3.8.3. Sites on an earlier version do not have it yet.

Product media

A product's images and documents (cut-out and lifestyle images, datasheets, safety data sheets, certificates, installation instructions and so on) are ordinary documents in the document store, linked to the product. Nothing is kept anywhere else: a file has the same folder permissions, preview, thumbnails, search, expiry date and version history as any other document. One document can be on any number of products.

Files reach a product in three ways:

  • a product import with media columns, as before;
  • the product's Media tab, one file at a time;
  • Link files to products on a supplier's folder, which matches many files to products by their file names.

On the product

The product's Media tab lists its files by media type. Each shows a preview (for images), its file name, its expiry date where it has one, and how many earlier versions it has. A file whose media type is not one of the site's types is listed under Other files. The tab keeps the media completeness bar.

A user with the edit role can:

  • Add a file to a type, either by uploading it or by choosing one from the supplier's PIM Media folder. An upload goes into that folder, which sits in the supplier's company folder beside PIM Prices, PIM Marketing and PIM Logistics: the folders a deal has, without the deal. They are made the first time one is needed. Uploading needs edit permission on the folder.
  • Take a file off the product. The document stays in the document store and on any other product.
  • Open the document to upload a new version, set its expiry date or see its earlier versions.

Each addition is checked against its type: the type must take that kind of file, and an image must be at least the type's minimum size. A type that takes one file per product replaces the file the product had. Every change goes to the product's history and the product is re-indexed.

Linking a folder's files to products

On a supplier's folder in the document store, the folder menu has Link files to products for users with the edit role, where the PIM is on version 3.8.3 or later. It reads the names of the documents in the folder (up to 2,000) and matches each to the supplier's products:

  • by GTIN: a valid 8, 12, 13 or 14 digit code anywhere in the name;
  • by part number: the supplier's or manufacturer's part number, ignoring case, spaces and punctuation, so 368744_CB50_cutout.jpg matches 368744 (CB50).

A media type is suggested from keywords in the name, such as sds, datasheet or lifestyle. An image with no keyword goes to the first image type the product has not got yet. The result is a preview: tick the files to link and change any type, then press Link. A name that matches several products is linked to each of them. Links refused by a type's rules are listed with the reason.

New versions and expiry

Both belong to the document, on its own page:

  • Upload New Version replaces the file and keeps the one it replaces as an earlier version (see The document detail view). Every product the document is on gets the new file, is marked as changed and records the change in its history.
  • The valid-to date of a time-sensitive document is its expiry date.

On a product data pool, each supplier is told overnight about documents on their products that have just come within 60 days of expiry, and again when one has expired. Expiring and expired documents show on the supplier's dashboard, and an expired document counts against the supplier's Confidence rating.

Media types

The types are set on Site Settings > PIM > Media types. A site with no list of its own uses the standard list (product image, lifestyle image, datasheet, safety data sheet, certificate, declaration of performance, installation instructions, brochure, video); Start from the standard list copies it in to be changed. Each type has:

  • a code, the media type code product imports write (MD01, MD22 and so on), and a name;
  • the kinds of file it takes (image, document, video, or file extensions), a minimum image size, and whether a product has one or several;
  • the file name keywords that suggest it when a folder's files are linked;
  • optionally the template attribute it fills. The product's Template tab then shows the file names as that attribute's value, so Data Levels and the gap report count the file as filled.

Names of codes not in the list

Imported products can carry media type codes that are not among the site's media types (a top view, a pictogram and so on). From 3.8.3 the Media Type filter on the catalogue names these from the standard names of the MD codes, with the code in brackets, instead of "Unknown Code". To give a code a different name, add it to the site's media types with that name. A code with no standard name is shown as the code alone.

Merchants and buying groups on a pool

A merchant or buying group sees a product's files as the supplier last published them, and only for products its access covers. It has no access to the supplier's folders: its files are served through the PIM, never the document store, and it never sees earlier versions.