Configuring Cloudinary Build Plugin

Plugin Inputs

NameRequiredExampleDescription
cloudNameNo*mycloudCloudinary Cloud Name
cnameNodomain.comThe custom domain name (CNAME) to use for building URLs (Advanced Plan Users)
deliveryTypeNofetchThe method by which Cloudinary stores and delivers images (Ex: fetch, upload)
folderNomyfolderFolder all media will be stored in. Defaults to Netlify site name
imagesPathNo/assetsLocal path application serves image assets from
loadingStrategyNoeagerThe method in which in which images are loaded (Ex: lazy, eager)
privateCdnNotrueEnables Private CDN Distribution (Advanced Plan Users)
uploadPresetNomy-presetDefined set of asset upload defaults in Cloudinary

Cloud Name must be set as an environment variable if not as an input

Environment Variables

NameRequiredExampleDescription
CLOUDINARY_CLOUD_NAMENo*mycloudCloudinary Cloud Name
CLOUDINARY_API_KEYNo1234Cloudinary API Key
CLOUDINARY_API_SECRETNoabcd1234Cloudinary API Secret

Cloud Name must be set as an input variable if not as an environment variable

Setting your Cloud Name

You have two options for setting your Cloud Name: plugin input or environment variable.

Netlify UI

Inside of your build settings, configure build environment variable (opens in a new tab) for the following:

Name: CLOUDINARY_CLOUD_NAME
Value: <Your Cloud Name>

File-based Configuration

Inside your Netlify config, add the following input configurations under your netlify-plugin-cloudinary plugin:

  [plugins.inputs]
  cloudName = "<Your Cloud Name>"