Strapi plugin logo for Cloudinary

Made by Strapi badge
Made by Strapi

Cloudinary provider for Strapi uploads





# using yarn
yarn add @strapi/provider-upload-cloudinary

# using npm
npm install @strapi/provider-upload-cloudinary --save


  • provider defines the name of the provider
  • providerOptions is passed down during the construction of the provider. (ex: cloudinary.config). Complete list of options
  • actionOptions is passed directly to each method respectively allowing for custom options. You can find the complete list of upload/ uploadStream options and delete options

See the documentation about using a provider for information on installing and using a provider. To understand how environment variables are used in Strapi, please refer to the documentation about environment variables.

Provider Configuration


module.exports = ({ env }) => ({
  // ...
  upload: {
    config: {
      provider: 'cloudinary',
      providerOptions: {
        cloud_name: env('CLOUDINARY_NAME'),
        api_key: env('CLOUDINARY_KEY'),
        api_secret: env('CLOUDINARY_SECRET'),
      actionOptions: {
        upload: {},
        uploadStream: {},
        delete: {},
  // ...

Security Middleware Configuration

Due to the default settings in the Strapi Security Middleware you will need to modify the contentSecurityPolicy settings to properly see thumbnail previews in the Media Library. You should replace strapi::security string with the object bellow instead as explained in the middleware configuration documentation.


module.exports = [
  // ...
    name: 'strapi::security',
    config: {
      contentSecurityPolicy: {
        useDefaults: true,
        directives: {
          'connect-src': ["'self'", 'https:'],
          'img-src': ["'self'", 'data:', 'blob:', '', ''],
          'media-src': ["'self'", 'data:', 'blob:', '', ''],
          upgradeInsecureRequests: null,
  // ...

Install now

npm install @strapi/provider-upload-cloudinary

Last updated

2 days ago

Strapi Version

4.0 and above


github profile image for Luca Perret
Luca Perret

Related plugin


Useful links

Create your own plugin

Check out the available plugin resources that will help you to develop your plugin or provider and get it listed on the marketplace.