Upload presets enable you to centrally define a set of asset upload options which can be applied to assets as they are uploaded to your account. By pre-defining these options, you can maintain the uniformity and compliance of your assets.
Common settings you can define in an upload preset include:
- Defining how the assets will be stored and accessed, such as the way the public ID value will be determined, which folders they'll be stored in, and whether existing assets can be replaced by those uploaded with the preset.
- Running add-ons on each uploaded asset, such as auto-tagging or background removal, so that assets are saved in your account automatically tagged, or with the background already removed.
- Applying transformations to assets, so that only the transformed copy is kept in your Media Library. For example, if users upload images of themselves to be used as profile pictures, you can set an upload preset to save them already cropped and resized, ensuring that those profiles are uniformly formatted.
- Marking uploaded assets for automatic or manual moderation.
In order to use upload presets, first configure one or more upload presets with your desired upload options. The upload preset(s) can then be applied to incoming assets in two different ways:
- Set the upload preset as the Media Library upload preset default. The upload preset will be applied by default to all assets uploaded to your Media Library.
- When uploading assets using the Media Library Upload Widget, the user selects an upload preset, appropriate to the relevant upload scenario, from a collection of upload presets that you've configured. For example, all assets used as hero images might be uploaded using an upload preset that transforms them in a certain way and saves them in a specific folder. The upload preset selected by the user when uploading overrides the default upload preset.
With a default upload preset, and/or a system of upload presets that must be applied for each specific use case, you can easily ensure that assets are handled correctly.
From the Cloudinary console settings, you can create and manage upload presets.
To create or modify an upload preset, select Settings > Upload and then scroll to the Upload presets section.
- Create a new upload preset by clicking Add upload preset at the bottom of the upload preset list.
- Click Edit to modify an existing preset.
- To base a new upload preset on an existing one, click Duplicate on the relevant upload preset. The new copy is added to the bottom of the list with a random name. You can then click Edit on the newly created upload preset to modify its name and update the settings as needed.
The upload preset options are organized in several tabs. The following sections describe the options in each tab that are relevant to DAM use cases:
- The Storage and Access tab: Contains options that relate to signing mode, naming, storage, access and delivery.
- The Media analysis and AI tab: Contains options for tagging and analyzing assets, also with the aid of optional add-ons.
- The Upload Manipulations tab: Contains options that relate to transforming assets, notifications and manipulations.
- The Upload Control tab: Contains options that relate to moderating assets and specifying advanced upload behavior that affects API calls.
The Storage and Access tab contains a variety of options that relate to signing mode, naming, storage, access and delivery. Choose the options that satisfy your needs.
Here are some of the Storage and Access options commonly used options in the Media Library:
- Signing mode: Upload presets can be either signed or unsigned. Only signed upload presets can be used from the Media Library. Unsigned upload presets allow uploads that are not authenticated, and can therefore be used in client-side code.
- Naming and storing incoming assets:
- You can set the destination Folder in the Media Library for where all assets uploaded via this upload preset will be saved, overriding the folder that the user may have selected.
- You can set the naming convention for the public ID used in delivery.
- You can allow incoming assets to Overwrite an existing one.TipTo enable overwriting assets, you'll also need to set Use filename or externally defined Public ID on and Unique filename off (to use the incoming file name as the public ID without a random suffix). Then, if you upload a new asset with the same file name as an existing asset's public ID, you'll be able to overwrite the asset.
- Access control mode: You can set the access control mode to either Public or Restricted.
Here are some of the Media analysis and AI options commonly used in the Media Library:
- Categorization: You can select from a number of add-ons to automatically tag your assets. In addition, you can set a minimum confidence threshold for a tag to be saved.
- Raw convert: You can select an add-on to automatically convert incoming raw files to a specified format.
- You can request different types of analysis to be performed on the assets, or select from a number of add-ons to perform analysis. Some options generate relevant information and others actually change the asset. For example, you can run the OCR add-on to automatically extract text detected in uploaded images, Background removal to automatically remove the background from uploaded assets, or Quality analysis to retrieve quality analysis data for the uploaded image.
The Upload Manipulations tab contains options that relate to transforming assets, notifications and manipulations. Choose the options that satisfy your needs.
Here are some of the Upload Manipulations options commonly used in the Media Library:
- Format: You can specify a format for all assets. If an asset is uploaded in a different format it will be converted to this format before saving it in the Media Library.
- Incoming Transformation: You can open an editor that allows you to build a transformation, such as cropping, special effects, overlays, etc., that will be applied to the asset before saving it in the Media Library.
- Context: You can specify a key-value pairs to annotate the uploaded resources and increase their searchability.
The Upload Control tab contains options that relate to moderating assets and specifying advanced upload behavior that affects API calls. Choose the options that satisfy your needs.
Here are some of the Upload Control options commonly used in the Media Library:
- Allowed formats: You can specify the file formats that will be allowed for uploading.
- Auto moderation: You can select the type of moderation that you want to apply to every asset uploaded.ImportantIf you select an automatic moderation, you must be subscribed to it, otherwise the moderation will not be applied and the asset will be immediately marked as approved.
When you finish and Save your upload preset definition, the upload preset and its settings are displayed in the Upload Settings page:
- When defining an upload preset that may be used for both image and video uploads, you can include both image-specific and video-specific upload options (e.g., for moderation or tagging add-ons) and only the relevant options will be used when a file is uploaded with that preset.
- If Dynamic folders mode is enabled on your account, there are a variety of additional options available for upload presets, both in the UI and the API. For details, see Dynamic folders - Upload preset options and Dynamic folders - New Upload API parameters.
To control the way all assets are uploaded, you can assign specific signed upload presets to act as the defaults for image, video, and raw uploads.
From the Media Library console settings, you can assign the default signed upload presets for uploads performed via the API and via the Media Library:
API upload preset defaults: relates to uploads performed via the API.
Media Library upload preset defaults: relates to uploads performed via the Media Library.
After you set the Media Library upload preset defaults, the relevant default upload preset will then be applied to every asset of that type that is uploaded via the Media Library UI from that point forward, unless a different signed preset is manually selected via the Media Library Upload Widget.