Image & Video APIs
Menu

Android SDK

Last updated: Dec-24-2025

The Cloudinary Android SDK provides simple, yet comprehensive image and video upload, transformation, optimization, and delivery capabilities through the Cloudinary APIs, that you can implement using code that integrates seamlessly with your existing Android application.

SDK security upgrade, June 2025
We recently released an enhanced security version of this SDK that improves the validation and handling of input parameters. We recommend upgrading to the latest version of the SDK to benefit from these security improvements.

How would you like to learn?

Resource Description
Android quick start Get up and running in five minutes with a walk through of installation, configuration, upload, management and transformations.
Sample projects Explore sample projects to see how to implement Cloudinary functionality such as upload and delivery with transformations.
Cloudinary Android SDK GitHub repo Explore the source code and see the CHANGELOG for details on all new features and fixes from previous versions.
Video tutorials Watch tutorials relevant to your use cases to learn how to use Cloudinary features.
Cloudinary Academy Try the free Introduction to Cloudinary's Android SDK online course, where you can learn how to upload, transform and optimize your assets, explore the native video player and integrate Image Loaders for seamless asset downloading.
Note
The Android SDK is Java based. If you are using Kotlin to develop your Android app, see the Kotlin SDK integration guide.

Install

Cloudinary's Android SDK is available in modules. Select the modules to install based on the following table:

Module Features Depends on:
Core
'com.cloudinary:cloudinary-android-core:[version]'		 Transformations, Upload, Client side responsive Java core: 'com.cloudinary:cloudinary-core:[version]'
Preprocess
'com.cloudinary:cloudinary-android-preprocess:[version]'		 Image and video upload preprocessing Core
Download
'com.cloudinary:cloudinary-android-download:[version]'		 Seamless integrations with 3rd party download libraries. Core
UI
'com.cloudinary:cloudinary-android-ui:[version]'		 Native upload widget with preview and preprocess UI Preprocess
All
'com.cloudinary:cloudinary-android:[version]'		 All of the above All of the above (explicitly and implicitly).

The following instructions detail the installation of the Cloudinary Android library. Note that there is no need for any ProGuard configuration. Use one of the following options:

Gradle installation

Add the module(s) within the dependencies section of your build.gradle file. For example:

Note
3.1.2 is the latest version at the time of publishing these docs. It's recommended to modify that value to the latest released version of the Cloudinary Android library in the code above.

Maven installation

Add the module(s) within the dependencies tag in your pom.xml file. For example

Manual installation

Download the following 2 files and put them in your libs folder:

Configure

To use the Cloudinary Android library you have to configure at least your cloud_name. You can additionally define a number of optional configuration parameters if relevant. You can find your Cloud name in the Dashboard of the Cloudinary Console, and you can find all of your credentials, including API Key and API Secret, on the API Keys page of the Cloudinary Console Settings.

Notes
  • Most functionality implemented on the client side doesn't require authentication, so only your cloud_name is required to be configured, and not your API key or secret.

    Your API secret should never be exposed on the client side, so if you want to use signed uploads or generate delivery signatures, you'll also need server-side code, for which you can use one of our backend SDKs.

  • For backward compatibility reasons, the default value of the optional secure configuration parameter is false. However, for most modern applications, it's recommended to configure the secure parameter to true to ensure that your transformation URLs are always generated as HTTPS.

The entry point of the library is the MediaManager object. The MediaManager.init() method must be called once per application lifecycle before using the Android library, preferably in Application.onCreate(). Setting the configuration parameters can be done either when initializing the library, or by using the CLOUDINARY_URL meta-data property in the AndroidManifest.xml file.

Config with init

To set the configuration parameters programmatically while initializing the MediaManager, pass a HashMap with parameters as the second argument of the init method. For example:

Config with meta-data

Alternatively, you can add the CLOUDINARY_URL meta-data property to the AndroidManifest.xml file, within the application tag. For example:

When using the meta-data property, no configuration is required when initializing the MediaManager:

Note
By default, URLs generated with this SDK include an appended SDK-usage query parameter. Cloudinary tracks aggregated data from this parameter to improve future SDK versions. We don't collect any individual data. If needed, you can disable the urlAnalytics configuration option. Learn more.

Use

Once you've installed and configured the Android SDK, you can use it for:

  • Upload: Upload images and videos from your mobile application directly to your Cloudinary product environment.
  • Transform and optimize: Dynamically transform and optimize your media assets on-the-fly using powerful transformations.
  • Deliver: Generate dynamic URLs for seamless delivery of transformed images and videos.

Quick example: File upload

The following Android code uses an unsigned upload preset to upload the dog.mp4 video to the specified sub-folder using the public_id, my_dog. When the video upload is complete, the specified notification URL will receive details about the uploaded media asset.

Learn more about upload

Quick example: Transform and optimize

Take a look at the following transformation code and the image it delivers:

sample transformation

This relatively simple code performs all of the following on the original front_face.jpg image before delivering it:

  • Crop to a 150x150 thumbnail using face-detection gravity to automatically determine the location for the crop
  • Round the corners with a 20 pixel radius
  • Apply a sepia effect
  • Overlay the Cloudinary logo on the southeast corner of the image (with a slight offset). Scale the logo overlay down to a 50 pixel width, with increased brightness and partial transparency (opacity = 60%).
  • Rotate the resulting image (including the overlay) by 10 degrees
  • Convert and deliver the image in PNG format (the originally uploaded image was a JPG)

And here's the URL that's automatically generated and included in an image tag from the above code:

In a similar way, you can transform a video.

Learn more about transformations

Android SDK features

The Android SDK provides the following key features:

  • Build dynamic URLs for delivering images and videos with on-the-fly transformations
  • Implement direct file upload from your mobile application directly to your Cloudinary product environment
  • Preprocess files before uploading
  • Handle asynchronous upload callbacks
  • Upload policy options (upload only on non-metered networks, only when charging, etc.) globally or per upload request
  • Automatic error handling for network disconnections, timeouts, etc.

Sample projects

Explore sample projects to see how to implement Cloudinary functionality:

e-commerce Demo App

Related topics

AltStyle によって変換されたページ (->オリジナル) /

✔️ Feedback sent!

✖️
How helpful was this doc page?

Thanks for submitting your rating. We got it!
We'd love to hear more. Tell us what you liked and how we can make this page even better:

*

Cloudinary is committed to protecting your information security. For details, see our privacy policy.

For additional assistance, open a support request.

Error

Unfortunately there's been an error sending your feedback.

Rate this page: