logo
logo

Downloading options

On the Download options page, users can apply various conversions to the selected asset files prior to downloading asset renditions.

A user is taken to the Download options page after selecting assets and then choosing the Download operation, which is displayed on the Asset Operations toolbar:

The Download options page displays the selected assets grouped by Asset media. This grouping is performed by default:

From the Asset media dropdown menu, a filter is shown based on the media of the selected assets. In this example, there are four Asset media types displayed:

  • Images
  • Vectors
  • Documents
  • Videos

By selecting an Asset media type from the dropdown menu, the selected assets are subsequently filtered and the Additional rendition options are similarly filtered:

File types

On each of the Asset media types there is a icon that displays which file types are included in the Asset media grouping. In the following example, the Images Asset media group is available for bmp, gif, jpeg, jpg, tga, raw, srw, raf, orf, nef, cr2, erf, dng, webp, dr, jfif, jp2, bpg, dpx, and crw file extensions:

Whereas the Asset media type of Documents handles the following file extensions: docx, xlsx, pptx, rtf, txt, doc, ppt, xls, pdf, eml, and msg:

And the Asset media type of Videos handles the following file extensions: avi, flv, mov, mpeg, wmv, mp4, webm, and m4v:

The Asset media type of Vectors handles the following file extensions: ai, eps, psb, tif, tiff, png, svg:

Asset media typeSupported file types
Documents media typedoc, docx, eml, msg, pdf, ppt, pptx, rtf, txt
Images media typebmp, bpg, cr2,crw, dng, dpx, dr, erf, gif, jfif, jp2, jpeg, jpg, nef, orf, raf, raw, srw, tga
Vectors media typeai, eps, png, psb, svg, tif, tiff
Videos media typeavi, flv, mp4, m4v, mov, mpeg, webm, wmv

The Download name field allows the user to provide a custom name for the download:

By providing an identifiable name, finding the specific download becomes easier on the Downloads. If no name is provided then by default the file is named Download {Mmm dd}:

Only the Asset media types are shown in the Additional rendition options for the selected assets:

Multiple asset media types shownSingle asset media type shown

There is a count indicator of the number of assets in each Asset media type grouping displayed in the Additional rendition options:

The count indicator is displayed for each Asset media type:

Additional rendition options

By default, all assets are downloaded in their original formats. For the media types of

  • Images
  • Vectors
  • Documents
  • Videos

The user can select specific renditions:

  • Original.
  • Medium.
  • Metadata.
  • Custom.

Users can select multiple renditions:

Metadata renditions

The metadata rendition, if selected, outputs a ZIP package containing a JSON file:

The JSON file contains all the metadata attached to the selected asset:

{
  "ExifTool:ExifToolVersion": "10.80",
  "File:FileName": "milo-mcdowell-2198.jpg",
  "File:FileSize": "246929",
  "File:FileModifyDate": "2020:06:02 20:51:28+00:00",
  "File:FileAccessDate": "2020:06:02 20:51:28+00:00",
  "File:FileInodeChangeDate": "2020:06:02 20:51:28+00:00",
  "File:FilePermissions": "644",
  "File:FileType": "JPEG",
  "File:FileTypeExtension": "JPG",
  "File:MIMEType": "image/jpeg",
  "File:ImageWidth": "1920",
  "File:ImageHeight": "1280",
  "File:EncodingProcess": "0",
  "File:BitsPerSample": "8",
  "File:ColorComponents": "3",
  "File:YCbCrSubSampling": "2 2",
  "JFIF:JFIFVersion": "1 1",
  "JFIF:ResolutionUnit": "1",
  "JFIF:XResolution": "72",
  "JFIF:YResolution": "72",
  "ICC_Profile:ProfileCMMType": "Lino",
  "ICC_Profile:ProfileVersion": "528",
  "ICC_Profile:ProfileClass": "mntr",
  "ICC_Profile:ColorSpaceData": "RGB ",
  "ICC_Profile:ProfileConnectionSpace": "XYZ ",
  "ICC_Profile:ProfileDateTime": "1998:02:09 06:49:00",
  "ICC_Profile:ProfileFileSignature": "acsp",
  "ICC_Profile:PrimaryPlatform": "MSFT",
  "ICC_Profile:CMMFlags": "0",
  "ICC_Profile:DeviceManufacturer": "IEC ",
  "ICC_Profile:DeviceModel": "sRGB",
  "ICC_Profile:DeviceAttributes": "0 0",
  "ICC_Profile:RenderingIntent": "0",
  "ICC_Profile:ConnectionSpaceIlluminant": "0.9642 1 0.82491",
  "ICC_Profile:ProfileCreator": "HP  ",
  "ICC_Profile:ProfileID": "0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0",
  "ICC_Profile:ProfileCopyright": "Copyright (c) 1998 Hewlett-Packard Company",
  "ICC_Profile:ProfileDescription": "sRGB IEC61966-2.1",
  "ICC_Profile:MediaWhitePoint": "0.95045 1 1.08905",
  "ICC_Profile:MediaBlackPoint": "0 0 0",
  "ICC_Profile:RedMatrixColumn": "0.43607 0.22249 0.01392",
  "ICC_Profile:GreenMatrixColumn": "0.38515 0.71687 0.09708",
  "ICC_Profile:BlueMatrixColumn": "0.14307 0.06061 0.7141",
  "ICC_Profile:DeviceMfgDesc": "IEC http://www.iec.ch",
  "ICC_Profile:DeviceModelDesc": "IEC 61966-2.1 Default RGB colour space - sRGB",
  "ICC_Profile:ViewingCondDesc": "Reference Viewing Condition in IEC61966-2.1",
  "ICC_Profile:ViewingCondIlluminant": "19.6445 20.3718 16.8089",
  "ICC_Profile:ViewingCondSurround": "3.92889 4.07439 3.36179",
  "ICC_Profile:ViewingCondIlluminantType": "1",
  "ICC_Profile:Luminance": "76.03647 80 87.12462",
  "ICC_Profile:MeasurementObserver": "1",
  "ICC_Profile:MeasurementBacking": "0 0 0",
  "ICC_Profile:MeasurementGeometry": "0",
  "ICC_Profile:MeasurementFlare": "0.00999",
  "ICC_Profile:MeasurementIlluminant": "2",
  "ICC_Profile:Technology": "CRT ",
  "ICC_Profile:RedTRC": "(Binary data 2060 bytes, use -b option to extract)",
  "ICC_Profile:GreenTRC": "(Binary data 2060 bytes, use -b option to extract)",
  "ICC_Profile:BlueTRC": "(Binary data 2060 bytes, use -b option to extract)",
  "Composite:ImageSize": "1920x1280",
  "Composite:Megapixels": "2.4576"
}

Custom renditions

Custom renditions are Asset media type-specific, and they allow users to customize the rendition to download the assets in.

Image and Vector renditions include the following properties:

  • Format: format specifies the file format for the download:

  • Color profile: when performing a custom download for images and vectors, there are two color profiles available out of the box:

    • sRGB

    • CMYK

    Sitecore Content HubTM also provides the functionality to upload and enable new color profiles in the application. Superusers can add color profiles in the Color Profiles management page (under Manage menu) by clicking on the Upload Files button and uploading their color profiles. The accepted color profile file types are .icc and .icm.

    The option to select color profiles is only available for assets in image formats, or for assets being downloaded in image formats.

  • Crop: there are three cropping options:

    • Don't crop

    • Crop to center

    • Smart crop

    The Crop option is only available for Raster image formats and non-proprietary Vector image formats. However, it is still possible to change the dimension of the downloaded asset by amending the Width or Height. The aspect ratio is locked:

    • Don't crop option provides a rendition that can be resized, but the aspect ratio is locked: as the height is changed, a corresponding change is made to the width and vice versa. The following steps describe the steps required in the utilization of the Don't crop option:

      • For the Crop property, select Don't crop.

      • For the Dimensions property, select either Don't resize or Custom width and height.

      • If Custom width and height is selected, the width or height can be changed to resize the downloaded assets. As one dimension is changed, the other is adjusted to meet the locked ratio.

      • The measurement of the Width and Height can be changed. The choice of measurements is:

        • pixels (by default)

        • inches

        • centimeters

        • millimeters

    The following table shows the difference between two output dimensions:

    DimensionsOriginal Rendition
    Original - Output dimensions 6000 x 4000 px
    Don't crop - Output dimensions 3000 x 2000 px
    • The Crop to Center provides a Rendition that can be resized with the aspect ratio unlocked. This option positions the crop box to the center of the image:

      • Select the Crop to center.
      • Select either Custom width and height or one the preset values.

      Dimension groupValues
      FacebookFacebook Cover Photo, Facebook Event Image, Facebook Highlighted Image, Facebook Shared Image.
      InstagramInstagram Photo, Instagram Stories.
      LinkedInLinkedIn Banner Image, LinkedIn Company Cover Image, LinkedIn Company Photos, LinkedIn Hero Photo, LinkedIn Personal Background Image, LinkedIn Shared Image, LinkedIn Shared Link.
      TwitterTwitter Header Photo, Twitter In-Stream Photo.
      YouTubeYouTube Channel Cover Art, YouTube Channel Profile Image.

      The following table shows a sample output with the Crop to center option:

      DimensionsOriginal Rendition
      Original - Output dimensions 3088 x 4624 px
      Crop to center - Output dimensions 1000 x 2000 px
    • Smart crop is a feature that intelligently examines the content of an image and automatically focuses on the most important part of the image for cropping. Smart crop provides an automatic search of the image for edges, skin tones and areas of saturated color, and attempts to position the crop box over the most significant feature. The width and height values specify the dimensions of the cropped area:

      The following table shows a sample output with the Smart crop option:

      DimensionsOriginal Rendition
      Original - Output dimensions 5000 x 7502 px
      Smart crop - Output dimensions 1000 x 600 px
  • Resolution (DPI): this property specifies the resolution of the rendition. DPI (dots per inch) refers to the output of the downloaded assets:

  • Filename: this property provides a filename for the downloaded assets. To use asset properties as variables, write the property name between curly brackets, e.g. {Title}:

    Warning

    Only single-line string properties are supported as filename variables.

    This Filename is then assigned to the file in the downloaded zip file:

    If the Filename is used for multiple downloaded assets, then the Filename will include a number at the end. In this example the Filename is test and is used for three assets:

Conversions

The following processing options can be defined:

Image Presets:

  • Original.
  • Medium.
  • Metadata.
  • Custom:
    • sRGB/ CMYK/ Custom Color Profile.
    • 72/ 150 / 300 DPI.
    • JPG/ PNG/ TIF.
    • Fill frame proportionally/ Fit frame proportionally.

Vector Presets:

  • Original.
  • Medium.
  • Other implementation-specific renditions: Renditions can be configured through Media processing (Under Manage). The Rendition Link needs to have the option UI selected in the Intended Area of use to be displayed here.
  • Custom:
    • sRGB/ CMYK/ Custom Color Profile.
    • 72/ 150/ 300 DPI.
    • JPG/ PDF/ PNG/ TIF.
    • Fill frame proportionally/ Fit frame proportionally.

Document Presets:

  • Original.
  • Medium.
  • Other implementation-specific renditions: Renditions can be configured through Media processing (Under Manage). The Rendition Link needs to have the option UI selected in the Intended Area of use to be displayed here.
  • Custom:
    • Mp3.

Audio Presets:

  • Original.
  • Other implementation-specific renditions: Renditions can be configured through Media processing (Under Manage). The Rendition Link needs to have the option UI selected in the Intended Area of use to be displayed here.
  • Custom:
    • Mp3.

Video Presets:

  • Original.
  • Other implementation-specific renditions: Renditions can be configured through Media processing (Under Manage). The Rendition Link needs to have the option UI selected in the Intended Area of use to be displayed here.
  • Custom:
    • Mp4.
    • WebM.

Individual download options

Individual download options are available via the icon, and they allow users to customize the download options for individual assets.

There is a choice of available renditions from the dropdown menu:

  • Original

  • Medium

  • Metadata

  • Custom

Please note it is a multi-select option:

After selecting the download options click on the button:

On the Download options page, clicking on button creates the download order:

After confirming the download order, users are automatically redirected to the Downloads page where the download job is created. Once the download order is complete, the download link becomes active. The status changes Ready, the user can download the package, which contains the requested files with the applied download/conversion options. Download orders remain available by default for seven days; this is a configurable setting.

Download options security

There is a permissions check for each asset rendition that is included in the downloaded ZIP file.

In this example, the demo_user wishes to download the Original and Medium renditions for both Images and Vectors assets.

However, the demo_user does not have the required DownloadPreview permission. The user can use the Individual download options to view which renditions they have permission to download. In this example, the demo_user sees that the Medium rendition controlled by (or secured by) the DownloadPreview permission is not available:

When the downloaded ZIP package is opened, it only contains five files instead of the expected eight files (two renditions per asset), due to insufficient permissions. Besides the assets, the package contains an additional report file in .txt format.

Opening the report file, the user can see which asset renditions failed to download due to insufficient permissions:

The following asset renditions failed to download due to insufficient permissions:

+----------+---------------------------+------------------+
| Asset ID | Asset name                | Renditions       |
+----------+---------------------------+------------------+
| 28634    | Waffles and Buck's Fizz   | preview_download |
| 28966    | Fruitful logo (black)     | preview_download |
| 28631    | Orange tree with blue sky | preview_download |
| 28816    | Fruitful presentation     | preview_download |
+----------+---------------------------+------------------+

The following table maps each rendition to its required permission:

RenditionPermission
OriginalDownloadOriginal
MediumDownloadPreview
MetadataOrder
CustomDownloadOriginal

Can we improve this article ? Provide feedback