Item images

Item images are saved on S3 and delivered using CloudFront, a CDN service by AWS. CDN is short for Content Delivery Network. CDN allows completely scalable delivery of item images. CDN makes it possible to only save the original image. A specified dimension of the original image is created when the image is displayed on screen. This dimension is then saved in the CloudFront CDN cache.

1. Managing images in the item view

In the item detail view you find the images menu. Here, you can manage all uploaded images of the item and add new ones. In the Details sub menu you can manage further settings like the name of the image, on which place in the image gallery of the item it should be displayed or for which client and referrer it should be available. You find all settings in [table-image-fields]

Field Explanation

Name - EN

Name of the image that is displayed in the shop or other sales channels.

Position

Determines the position of the image, if more than one image is connected to the item or variant.

*Alternative text - EN

Enter an alternative text for the image. If the image can’t be displayed (e.g. because of browser settings, firewall, etc), then the customer will see the alternative text instead. The alternative text is not relevant for SEO. It is simply displayed as an alternative to the image.

Availability

Determines for which client and referrer the image is available. You can select all clients and referrers or pick specific ones.

You can also determine the availability for several images simultaneously via the group function. Select all images that should have the same availability. Click on Assign availability (storage) in the top right to manage all selected items at once.

Market attribute link

Select an attribute value to link the item image for marketplaces with this attribute value. The image will only be transferred to marketplaces where item variations have this attribute value.

more_vert

Via this menu you can copy the image URL or delete images.

You can delete several images at once using the group function. Select all images you want to delete. Then, click on Delete images (delete) in the top right.

1.1. Link image with variation

You can link images that you uploaded to an item with variations. This way, you ensure that the image fits the properties of the variation, for example furniture that has different colours.

Proceed as follows to link an image to a variation:

  1. Go to Item » [Open item] »Images » Details.

  2. Click on Link image (link) at the image you want to link.
    → The*Link to variation* menu opens.

  3. Select the variant(s) that you want to link to the image.
    Tip: Use the search and filters in the menu to limit the results.

  4. Click on Link (link).

The image has been successfully linked. Do you want to link several images with a variation at once? Use the group function.

Proceed as follows to link images via group function to a variation:

  1. Go to Item » [Open item] »Images » Details.

  2. Select all images you want to link. Or: Select All images EN above the images, if you want to link all images.

  3. Click on Link to variation (link) in the top right.

  4. Select the variant(s) that you want to link to the image.
    Tip: Use the search and filters in the menu to limit the results.

  5. Click on Link (link).

2. Translating image texts

In the*Translations* sub menu you can determine name and alternative texts for all images. Besides that you can transfer texts from one language into another. For example: if you want to use English placeholder for French, Spanish and Italian, you don’t have to type them in again and again.

Proceed as follows to transfer text in another language:

  1. Go to Item » [Open item] »Images » Details » Translations.

  2. Click on Transfer text (text_select_move_forward_word).
    → The Transfer texts menu opens.

  3. Select a source language.

  4. Select one ore several target languages.

  5. Click on Execute.

The texts were successfully transferred.

Via Delete texts (delete) you can delete texts for one or more languages. If you used placeholder for several languages before, you can remove them at once and add the actual texts.

Proceed as follows to delete texts:

  1. Go to Item » [Open item] »Images » Details » Translations.

  2. Click on Delete texts (delete).
    → The Delete texts menu opens.

  3. Select from the drop-down list one or more languages that you want to delete the texts from.

  4. Click on * Delete.

The texts were successfully deleted.

3. General settings

  1. Go to Setup » Item » Images » Settings.
    → The menu is divided into several areas.

  2. Carry out the settings in each area.

  3. Save () the settings.

3.1. Settings

This area relates to the import and export of item images.

Setting Explanation

Export item image position

Select a position number from the drop-down list. This is the item image’s position number for the image export, for example to a market.
The position is defined in the item’s Images tab.

Image import using FTP

Should existing images be deleted before new images are imported? Choose your preference from the drop-down list.

  • Add imported images = New images will be imported. Existing images will be retained.

  • Delete existing images before import = First, existing images will be deleted. Second, new images will be imported.

Image names of FTP import

Will you upload images with an FTP server? Then your image file names will either need to contain the item ID or the variation number. Use the drop-down list to specify which identifier the image file names contain.

3.2. Placeholder images

This area relates to placeholder images. If an item does not have its own image, then the placeholder image will be displayed instead.

Setting Explanation

URL of placeholder image

This placeholder image appears if item images cannot be displayed.

  1. Upload your preferred placeholder image in the menu Shop » Webspace.

  2. Then enter the URL for the placeholder image here.

URL of placeholder preview image

This placeholder image appears if preview images cannot be displayed.

  1. Upload your preferred placeholder image in the menu Shop » Webspace.

  2. Then enter the URL for the placeholder image here.
The Plenty Webspace

Every PlentyONE system comes with a dedicated Webspace that allows you to store files online in your system. Additionally, all files stored in a Webspace receive a File URL which can be used to make each file available to other users and applications online. You can manage the Webspace of your system in the Shop » Webspace menu.

WARNING: Usage of the webspace may incur additional costs. The exact terms of use of the Webspace are outlined in your contract with PlentyONE.

3.3. Attribute images

This area relates to attribute values that are displayed as images. For example, if customers should click on a red image to select the colour red.

Setting Explanation

Max. height in pixels

Enter the maximum height of the image in pixels.

Max. width in pixels

Enter the maximum width of the image in pixels.
Additional settings

Upload the necessary images and specify that you want the attributes to be displayed as images in the webshop. These settings are explained in further detail here.

3.4. Name

This area relates to image names. Specifically, you’ll decide which information should be included in the image names.

Setting Explanation

Original name;
Item ID;
Item No.;
Name 1 - Name 3;
Keywords;
Model;
Free text field 1 - Free text field 20

Select a position number for each desired parameter. This simultaneously specifies which parameters the image name should contain and which of these parameters should be displayed first, second, third, etc.

Technical specifications:

  • The parameters will be separated by hyphens in the image name.

  • You have to specify the item ID or the item number.

  • The image name is limited to a maximum of 32 characters.

Own prefix;
Prefix

You are not limited to the item parameters listed above. It is also possible to create your own prefix and add it to the image name.

  1. Enter your own prefix into the text field Prefix.

  2. Select a position number from the Own prefix drop-down list.

4. Defining image sizes

  1. Go to Setup » Item » Images » Sizes. The menu is divided into areas for four different image sizes:

    1. preview = Preview image

    2. secondPreview = Second preview image

    3. middle = Mid-sized image

    4. full = Full-sized image

  2. Carry out the settings for each image size.

  3. Save () the settings.

Setting Explanation

Settings

Name

Enter an internal name for this image size.

Folder name

The folder name for this image size. The folder name cannot be changed and is part of the item image’s URL.

Maximum height in pixels

Enter the maximum height in pixels for images of this size. If your item image exceeds this size, then the displayed image will be scaled down. The aspect ratio will stay the same.

Maximum width in pixels

Enter the maximum width in pixels for images of this size. If your item image exceeds this size, then the displayed image will be scaled down. The aspect ratio will stay the same.

Max. lifetime of cache in days

How long should the images be saved in the CloudFront cache? Enter a number of days. The image’s lifetime begins once the image has been displayed on screen in this size, i.e. loaded into the cache.

image lifetime in days

How long should the length, width and size of the image be saved in the CloudFront cache? Select an option from the dropdown menu: 1 day, 7 days, 14 days, 30 days, 90 days, 180 days and 365 days
The image’s lifetime begins once the image has been displayed on screen in this size, i.e. loaded into the cache.

Rotate the output image based on the EXIF Orientation tag

Select this option () if you want to retain the original image orientation (image rotation of 90, 180, 270°).

Retain meta data (EXIF, XMP, IPTC) of original image

Select this option () if you want to retain the meta data of the original image. Examples of meta data are description texts, geo data (GPS), date and time.

Tip: In some cases, e.g. for preview images, it makes sense not to retain metadata in order to optimise loading time and data volume.

Do not enlarge

Should original images be enlarged?

  • = If the original image is smaller than the maximum dimensions defined for this size, then the image will be enlarged to this size.

  • = The original image will not be enlarged.

Pre-generate image size on upload

Select this option () to automatically adapt the uploaded image to the selected dimension.

Jpg

Quality

Use the slider to select a compression level between 0 and 9. Compression reduces load times and can help you achieve better page speed values.

Tip: Compressing images to 8 results in no visible loss of quality.

Progressive

Should images of this size be displayed immediately when the page is accessed?

  • = The image is available at low resolution as soon as the page is loaded. The quality of the image increases gradually during page load.

Png

Compression level (0-9)

Use the slider to select a compression level between 0 and 9. Compression reduces load times and can help you achieve better page speed values.

This is the compression level that will be used for PNG files. PNG is a loss-free format. As such, PNG images are always decompressed and shown at the original quality. However, if you select a higher compression level, the browser needs more time to decompress the image.

Progressive

Should images of this size be displayed immediately when the page is accessed?

  • = The image is available at low resolution as soon as the page is loaded. The quality of the image increases gradually during page load.

WebP

Compression level (0-9)

Use the slider to select a compression level between 0 and 9. Compression reduces load times and can help you achieve better page speed values.

Lossless compression

The file is compressed while keeping its image quality.

Near lossless compression

The file has a higher compression in comparison to lossless compression. Side effects are image distortion.

AVIF

Compression level (0-9)

Use the slider to select a compression level between 0 and 9. Compression reduces load times and can help you achieve better page speed values.

Lossless compression

The file is compressed while keeping its image quality.
Invalidate CDN cache

After making changes in the menu Setup » Item » Images » Sizes, your images may still be displayed with the old settings because the changes are in the cache. Click on Invalidate CDN cache, to show the changes more quickly. The cache invalidation is done by CloudFront. After you invalidate the cache, each image size is created on the fly when the image is opened.

5. Personalising image URLs

By default, image URLs have a standard CDN domain name. But it’s possible to use your own domain and subdomain instead.

The table compares the default CDN domain and a custom CDN domain.

Image URL with default domain Image URL with own domain

URL pattern

The URL of item images is created as follows:

  1. Subdomain CDN1, CDN2 or CDN3

  2. Domain plentymarkets.com

  3. Customer hash

  4. File path item/images

  5. Item ID

  6. Folder name of image size

  7. Name of image file with file extension

The own domain is specified instead of the default domain. The customer hash is not shown in the URL:

  1. Own subdomain.

  2. Domain of the client

  3. File path item/images

  4. Item ID

  5. Folder name of image size

  6. Name of image file with file extension

Example URL

https://cdn01.plentymarkets.com/1abcd2e3fghi/item/images/118/full/118-Chair-Rio.jpg

https://yoursubdomain.yourstore.co.uk/item/images/118/full/118-Chair-Rio.jpg
Limitations

  • A custom subdomain can only be saved for the main domain.

  • You can only save one custom subdomain per client.

  • The subdomain must not contain www.

  • The subdomain must not exist in the domain assistant.

5.1. Setting up your own CDN domain: PlentyONE domain

These instructions teach you how to set up your own CDN domain, assuming that your domain is hosted by PlentyONE.

Domain hosted by an external provider?

Is your domain hosted by an external provider? Then follow the instructions here instead.

A domain hosted by PlentyONE:

  1. Go to Setup » Client » [Select client] » CDN-Domains.
    → Any existing CDN domains will load automatically. This can take a few minutes.

  2. Click on .
    → The New domain window opens.

  3. Carry out the settings. Note Table 1.

  4. Save the settings.
    → The subdomain is created.

  5. Wait until check marks appear in the columns SSL, DNS and Cloud status. The process can take several hours. It is completed when all three check marks appear. The check marks mean:

    • An SSL certificate was created for the subdomain.

    • A DNS record was created for the subdomain.

    • A CloudFront instance was created.

  6. Once all three check marks are displayed, activate the domain ().

Table 1. Saving a subdomain for image URLs
Setting Explanation

Section

Select the type of subdomain from the drop-down list. Currently, only the type CDN1 is available.

Subdomain

Enter a custom subdomain. Valid characters are letters (a-z, A-Z), numbers (0-9), underscore (_) and hyphen (-). The first character of the subdomain must be either a letter or a number.

Domain

Select the domain from the drop-down list. You can only select the client’s main domain.
Activate the domain after the subdomain has been created

It can take several hours for the subdomain to be created. The creation process is complete when checkmarks are shown in all three columns, i.e. SSL, DNS and Cloud status. Once the subdomain is created, activate the domain.

5.2. Setting up your own CDN domain: external domain

These instructions teach you how to set up your own CDN domain, assuming that your domain is hosted by an external provider.

  • First you’ll generate DNS entries in PlentyONE.

  • Then you’ll have 72 hours to save these DNS entries with your external domain provider.

Domain hosted by PlentyONE?

Is your domain hosted by PlentyONE? Then follow the instructions here instead.
Check the CAA records

CAA records define which certificate authorities (CA) are allowed to issue certificates for a specific domain.
You have 72 hours to save the DNS entries with the provider

The DNS entries that are generated in PlentyONE need to be saved with the external domain provider within 72 hours. Otherwise the DNS entries will be invalid once the time is up.

If you’ve created a CDN domain but you didn’t save the DNS entries with the provider on time, then you’ll be missing one of the three check marks in the back end and it will not be possible to activate the domain.
What is DNS?

DNS is short for Domain Name System. DNS makes it possible to enter the domain name instead of the numerical IP address of your shop.

A domain hosted by an external provider:

  1. Go to Setup » Client » [Select client] » CDN-Domains.
    → Any existing CDN domains will load automatically. This can take a few minutes.

  2. Click on .
    → The New domain window opens.

  3. Carry out the settings. Note Table 2.

  4. Save the settings.
    → A DNS record is created for the subdomain.

  5. In the line of the domain record, click on and then on DNS info.
    → The DNS info window opens and the DNS settings are displayed.

  6. Log into the service area of your domain provider.

  7. Copy the DNS settings shown in PlentyONE into the relevant fields of the domain provider. Check the documentation of the domain provider on how to do this.

  8. When you open the menu Setup » Client » [Select client] » CDN-Domains, do you see check marks displayed in the columns SSL, DNS and Cloud status? Then the process is complete. The check marks mean:

    • An SSL certificate was created for the subdomain.

    • The DNS settings were updated.

    • A CloudFront instance was created.

  9. Once all three check marks are displayed, activate the domain ().

Table 2. Saving a subdomain for image URLs
Setting Explanation

Section

Select the type of subdomain from the drop-down list. Currently, only the type CDN1 is available.

Subdomain

Enter a custom subdomain. Valid characters are letters (a-z, A-Z), numbers (0-9), underscore (_) and hyphen (-). The first character of the subdomain must be either a letter or a number.

Domain

Select the domain from the drop-down list. You can only select the client’s main domain.

6. Uploading images via FTP server (only for older systems)

Older systems have their own FTP server. This FTP server contains the folder upload_article_image_XXXX (XXXX = plentyID). You can upload item images into this folder. The folder is checked for changes every 60 minutes. New, correctly named images are assigned to the correct item automatically. In order to upload files, you’ll need an FTP program and your FTP login details.

FTP server is only available for older systems

New systems are no longer equipped with an FTP server. Existing customers can continue using the FTP server for now. The EOL date has been postponed indefinitely.
100 images can be uploaded per item

You can upload up to 100 images per item, i.e. per item ID. This is a hard limit in the user interface. If you were to upload e.g. 150 images, then only the first 100 would appear in the user interface. Note that the limit applies to the entire item, i.e. to all of the variations together.

6.1. Naming the files correctly

  1. Go to Setup » Item » Images » Settings.

  2. Use the option Image names of FTP import to specify whether the file names contain the item ID or the variation number.

  3. Depending on what you selected, you’ll either name the files with the item ID or the variation number.

Valid characters for file names

The following characters are supported for image file names:

  • Letters (a-z, A-Z) excluding umlauts

  • Numbers (0-9)

  • Underscores (_)

  • Hyphens (-)

Spaces and special characters are not permitted. When you upload images, spaces and special characters are replaced by hyphens (-).
Multiple images per item

You can upload up to 100 images per item. Number the image files as follows:

  1. Item ID or variation number

  2. Three hyphens ---

  3. Number from 0 to 99

Examples

You want to upload images for an item with item ID 4562 and the variation number AQ3957.

Table 3. Examples of FTP compliant naming of item images
Setting Naming 1 image per item Naming more than 1 image per item

Image names of FTP import = Item ID

  • 4562.jpg

  • 4562.png

  • 4562.gif

  • 4562.svg

  • 4652---0.jpg

  • 4652---1.jpg

  • 4652---2.gif

Image names of FTP import = Variation number

  • AQ3957.jpg

  • AQ3957.png

  • AQ3957.gif

  • AQ3957.svg

  • AQ3957---0.png

  • AQ3957---19.png

6.2. Importing images

  1. Copy the item images that you want to upload using FTP to a folder on your hard drive.

  2. Check the names of the image files and modify these names if needed.

  3. Select the target folder upload_article_image_XXXX (XXXX= plentyID) in your FTP program.

  4. Select the files in the upload area of your FTP program.

  5. Start the upload.
    → The images are assigned to the items and displayed in the shop after up to 60 minutes.

Take upload time into account

200 images are processed in each run, 2000 images if you have your own server. Depending on the data volume, the upload may take several hours, even if you have a powerful computer and a fast data connection. Therefore, schedule the file upload at a time when it will not interfere with your day-to-day business.