File collections and download sizes


Infradox XS  - 26.4 or later



Related articles

Price calculator for RM images

Configuring the Cart page 

Configuring download permissions

Linking files to suppliers

Displaying file sizes, prices etc


As described in the article Linking files to suppliers, every file must be linked to a supplier record. The supplier record is - among other things - used to determine in which file sizes you want to make files available by linking suppliers to File collections. You can create collections for RF and for RM files. Usually RF files are offered for fixed prices depending on the size of the file that the user wants to download. You can specify prices for each size that you want to make available. For RM images, you can use the Price calculator so that users can get pricing information based on their intended use (by selecting a number of variables, e.g. use, size, circulation and so on). 

  • For RF images, collections are used to determine available download sizes and prices for each available size.
  • For RM images, collections are used to determine available download sizes only, prices are not affected by the selected size.
  • Available sizes may vary per image based on the size of the master file, and a minimum price as configured for a supplier. 
  • For information about how you can change which file information is displayed, when and where - read the article about Displaying file sizes, prices etc.

Note, some functions described in this article are only available in 26.4 or later.

Creating or changing File collections

In the Administrator Dashboard, click Price calculator, then click File collections in the bar on the left. In the toolbar at the top, click New collection. If you use live connections with 3rd party API's then you need to select the correct API. By default, use the Infradox API setting. If you are creating settings for RF files on your website, then select the RF radio button. 

You can define 10 different settings for each collection. Setting 1 is always for the largest available file (the original or so called Master file). If you don't want to make other sizes available then deselect all other settings (2 through 10).

By default there are 10 size settings that you can choose from. Note that in 26.4 or later, you can change the sizes that each of these settings will generate (maximum size is 10,000 pixels). More about this in the following paragraph.

Which settings you need to use depends on the size of the original files that you are connecting to this File collection. For instance, if you have a collection with master files up to 8000 pixels, then the second setting could be 6000 pixels, the 3rd one 4000 pixels, the 4th one 2000 pixels and the last one 1000 pixels 72dpi for web use. E.g.

  • 1 Original / Super high res / 300 dpi
  • 2 High res . 6000 pixels / 300 dpi
  • 3 Medium res 4000 pixels / 300 dpi
  • 4 Low res 2000 pixels / 300 dpi
  • 5 Web 1000 pixels / 72 dpi 

The smaller files are created on-the-fly from the master file. This may affect the quality of the file as a result of compression and re-sizing algorithms.

Pixel sizes of derived files (XS API Size codes)

(26.4 or later) Smaller image files are created on-the-fly from the master file. Within the context of Infradox XS, such files are referred to as Derived files. The file size in pixels for each of the download size codes (code 2 to code 10) can be changed to suit your specific needs. Code 1 can't be changed because it's reserved for the master (original) file.

To change the pixel size for a download size code, click XS API Size codes in the bar on the left. Codes 2 to 10 are listed. Click Edit in the row of the code that you want to change. Then enter a size in pixels and change the DPI setting as required - normally this should be 300 for higher resolution files and 72 for files that are intended for web use. 

If you have both very large files and relatively smaller files, then you can for instance use 2 codes for medium res. E.g. change one code to 4000 pixels and select it in collection A as the size for Medium res. And then change another code to 2500 pixels - which you then select as the size for Medium res in collection B. The system will automatically select the best suited file collection depending on the size of the master file if you linked the two collections together (as described further down in this article). In this example, collection A will be used for very large files, collection B will be used for smaller files.

Important Changing the pixel and/or DPI settings for a code affects all the collections in which the code is used. So if a user downloads a file again after you have made changes as described above, the new settings are used. 

How available file sizes are determined for an image file

  • Available sizes are determined by looking up the assigned collection for the file's supplier - unless the file is assigned to a specific collection (read the next paragraph for further information). 
  • If no collection is assigned to the supplier, then the collection that is assigned to the supplier's group is used.
  • If no collection is assigned to the supplier's group either, then the "Default" collection is used.
  • If the size of the master file (longest side in pixels) is less than the largest derived size of the collection, then the attached collection is used instead (see below for more information about attaching collections). 
  • The available sizes and prices are taken from the collection settings. The first available size is always the master file / original file.
  • If the supplier has a minimum price that is higher than the price specified for an available size, then that size becomes unavailable.
  • If a minimum difference (Site configuration, Metadata display, Collection file size settings) in pixels is specified, then available file sizes are made unavailable if the difference between a size and the previous version is less than the number of pixels specified. For instance, if the master file is 3400 pixels, the next available derived size is 3000 pixels and the minimum difference is 500, then the 3000 pixels version becomes unavailable. 

RF prices

Once a collection has been determined, the price for each of the available sizes is automatically determined.

  • If the price that is configured for a specific size is lower than the supplier's minimum price for RF images, then that size is removed (i.e. not available for download).
  • If the price for the master file is lower than the supplier's minimum price, then the price will be automatically adjusted to the minimum price.
  • If the price is adjusted to the minimum price and the end user has a discount percentage, then the price is raised with the user's discount so that the final price is never below then configured minimum price.
    For example, if the minimum price is 100 Euro and the user discount is 10%, then the price will be adjusted to 111.11 Euro.
    Calculated as follows: (100 Euro divided by (100%-10%)) multiplied with 100.
    With 10% discount the price will then be equal to the supplier's minimum price of 100 Euro.

Overriding the collection for a single file

Version 26.4 allows you to assign a specific collection to a file. To do this, find the file and edit its properties. Then select a collection in the dropdown box. Once you have saved the properties, the assigned collection will be used to determine available sizes, prices, display options and so on.

Displaying file info for the master file and derived files

  • Derived files are files that don't exist on the storage servers, such files are created on-the-fly from the master file.
    Which derived file sizes are available depends on how you have configured the related settings (as explained above).
  • File information is automatically created based on the size of the master file and the settings of the collection. 
    • Size in pixels e.g. 3661 x 2472 pixels
    • Size in cm e.g. 31 x 20.93 cm (300 dpi)
    • Size in inches e.g. 12.2 x 8.24 inch (300 dpi)
    • Size on disk/compressed file size e.g. 1.0 MB size on disk
  • You can hide all file information for any derived file size by "unchecking" the checkbox in the column "Display file info" in the collection properties dialog.
  • If you don't want to hide file information altogether, but just certain properties (e.g. no print sizes), then go to Site configuration, Metadata display, Collection file size settings to configure what you want to display. You can also use CSS. This is explained in the article about displaying file sizes and prices.
  • You can choose to display only the master file's file information on preview pages via Site configuration, Metadata display, Collection file size settings.

Checking the collection used for a file

If you are logged in with an admin account, you can check the collection that is being used by clicking the Admin info link underneath the thumbnail on the cart and order pages, and underneath the label Available files on the preview pages. The information includes the base price, the supplier's minimum price, the supplier id and the supplier's group id.

Collection functions

Use the clone to create a copy of an existing collection that you can then edit.

Click on either the Suppliers or Groups links in the column on the right to see the suppliers and groups to which a collection is linked.

You can delete a collection but if the collection was linked to a supplier or group, make sure to go to Supplier management to assign a different collection. 

Attaching collections to primary collections for automatic selection based on file sizes 

If you have files that vary considerably in size in the same collection, then you can create multiple collections and you can then attach collections to each other. For example, let's say that you have a supplier group with two suppliers. Supplier A has files that are 7000 pixels and supplier B has files that are 4000 pixels. If you look at the above example, size 2 would mean that "High res" is 6000 pixels. But the master files of supplier B are only 4000 pixels. By creating an additional collection that you then attach to the main collection, the system will automatically select the appropriate sizes for supplier B but you can still offer the same prices and display the available options with the appropriate names.

So let's say collection 1 has High res 6000 pixels for 100 Euro and Medium res 4000 pixels for 50 Euro.
And collection 2 (which is attached to collection 1) has High res 3000 pixels for 100 Euro and Medium res 2000 pixels for 50 Euro
A file from supplier A will use the settings of the primary collection (1) and a file from supplier B will use the settings of the attached collection with smaller sizes.

Important, always link the collection with the largest sizes to a supplier or supplier group. You can attach one or more other collections (with smaller sizes) to a single collection.





Have more questions? Submit a request


Article is closed for comments.
Powered by Zendesk