Configuring Cloudinary Build Plugin
Plugin Inputs
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| cloudName | string | No* | mycloud | Cloudinary Cloud Name |
| cname | string | No | domain.com | The custom domain name (CNAME) to use for building URLs (Advanced Plan Users) |
| deliveryType | string | No | fetch | The method by which Cloudinary stores and delivers images (Ex: fetch, upload) |
| folder | string | No | myfolder | Folder all media will be stored in. Defaults to Netlify site name |
| imagesPath | string/Array | No | /assets | Local path application serves image assets from |
| loadingStrategy | string | No | eager | The method in which in which images are loaded (Ex: lazy, eager) |
| privateCdn | boolean | No | true | Enables Private CDN Distribution (Advanced Plan Users) |
| uploadPreset | string | No | my-preset | Defined set of asset upload defaults in Cloudinary |
Cloud Name must be set as an environment variable if not as an input
Environment Variables
| Name | Required | Example | Description |
|---|---|---|---|
| CLOUDINARY_CLOUD_NAME | No* | mycloud | Cloudinary Cloud Name |
| CLOUDINARY_API_KEY | No | 1234 | Cloudinary API Key |
| CLOUDINARY_API_SECRET | No | abcd1234 | Cloudinary 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>"