Media repository
The Media area is used to manage image files and PDFs that are assigned to articles in the catalogue. The assignment happens automatically via the file name; manual assignment is not possible.
Table of contents
- Basics of providing media
- Ways to provide images
- Providing videos and documents
- Permitted formats and file sizes
- Notes on naming
- Updating media
- Activation of uploads and updates
- FAQ
- Video guide
Basics of providing media
Media can be provided directly via the BMEcat catalogue. This defines in the catalogue which media belong to an article and where they are stored.
Media can include, for example:
- product images
- technical documents
- videos
- other supplementary product information
The media is displayed on the article page in the customer portal and helps customers assess a product.
Ways to provide images
Images can be provided in two ways.
Images as a file (upload to the platform)
- images are stored on our platform
- the file name is stored at the defined location in the catalogue
- the image files must be uploaded to the platform as a .zip file
Example of a catalogue definition:
image/jpeg
Werkzeuge/Bild1.jpg
In this example:
- the image file is called Bild1.jpg
- it is located inside the ZIP file in the Werkzeuge folder
The path specified in the catalogue must exactly match the folder structure of the ZIP file.
Examples:
- if the file is in the Werkzeuge folder, Werkzeuge/Bild1.jpg must be specified in the catalogue
- if the file is directly in the ZIP archive, no folder may be specified in the path
If the paths do not match, the image cannot be found.
Important note:
- ZIP files should ideally not contain any folders, only files
- if folders are used, the same structure must be specified in the catalogue
Images as a link (hosted externally)
Alternatively, images can be provided via an external link.
- images are stored externally
- a link to the image source is stored in the catalogue
- when an article is opened, the image is loaded from this source
Example:
url
https://company.simplesystem.com/lieferanten/beispiel.jpeg
The following applies:
- the image must be permanently available at this source
- a sufficient retrieval speed should be ensured
Mixed use of image files and image links is generally possible.
If an article is contained in several catalogues, the source defined in the respective catalogue is used in each case.
Providing videos and documents
Videos and documents are provided via a deep link.
The following applies:
- the file is stored externally
- a link to the external source is stored in the catalogue
The display takes place in the customer portal:
- in the "Additional documents" section of the article detail page
Videos open in a separate browser window when opened and are loaded from the external source.
Important:
- the files must remain permanently available externally
- good retrieval speed should be ensured
Permitted formats and file sizes
The permitted media formats are based on the respective valid definition of the BMEcat standard.
Our platform currently supports the versions:
- BMEcat 1.2
- BMEcat 2005
Typical MIME type values are, for example:
- url – link to a resource on the internet
- application/pdf – PDF document
- image/jpeg – JPEG image
- image/gif – GIF image
- text/html – HTML document
- text/plain – text file
- application/xml – XML file (from BMEcat 2005)
A complete overview can be found in the BMEcat standard documentation.
Regarding file size: there is no fixed maximum file size
In practice, the maximum upload size often depends on the browser used.
Notes on naming
For media to be processed correctly, the file name specified in the catalogue must exactly match the name of the uploaded file.
Important rules:
- file name in the catalogue = file name on the platform
- path information must match exactly
- maximum length in BMEcat: 250 characters
Updating media
Existing media can be updated at any time.
The following applies:
- the file is uploaded again under the same file name
- the existing file is automatically replaced
For an update, only the affected files need to be updated.
A complete re-upload of all media is not required.
Uploaded media files cannot be deleted or renamed.
Activation of uploads and updates
After the upload, the media is processed.
The following applies:
- the upload is placed in a queue
- once processing is successfully completed, the media is activated
Prerequisite:
- the catalogue in which the media is stored is assigned to one or more customers
In the portal, you can see at any time:
- the current processing status
- when the media went live
For images embedded via links, the update takes place automatically when a new catalogue goes live.
FAQ
Why should I provide media for my products?
Images, videos, and documents help customers assess a product and increase the likelihood of a purchase.
Can I host images externally?
Yes. Images can be stored as a file on the platform as well as embedded via external links.
Can I combine images and image links?
Yes. Mixed use within a catalogue or across several catalogues is possible.
How do I update an image?
Simply upload a new file with the same file name. The existing file is automatically replaced.
Is there a maximum file size?
No. In practice, the maximum size usually depends on the browser used.
Video guide
Need help?
Do you have technical questions or problems uploading media? Our technical support team will be happy to help.
Email: support@simplesystem.com
Phone: +49 (0) 89 / 998 2987 00
Telephone service hours
Monday–Thursday: 8:00 a.m.–4:00 p.m.
Friday: 8:00 a.m.–3:00 p.m.