Image & Video APIs
Menu

Flutter SDK

Last updated: Dec-01-2025

The Cloudinary Flutter SDK provides simple, yet comprehensive image and video transformation, optimization, and delivery capabilities through the Cloudinary APIs, that you can implement using code that integrates seamlessly with your existing Flutter 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
Flutter quick start Get up and running in five minutes with a walk through of installation, configuration, and transformations.
Video tutorials Watch tutorials relevant to your use cases, from getting started with the Flutter SDK, to transforming your images and videos.
Cloudinary Flutter SDK GitHub repo Explore the source code and see the CHANGELOG for details on all new features and fixes from previous versions.

On this page:

Install

Cloudinary's Flutter SDK is available as an open-source package. To use this SDK, add Cloudinary as a dependency in your pubspec.yaml file:

Note
The Flutter mobile framework library must be used in conjunction with the Dart backend library to provide all of Cloudinary's transformation and optimization functionality. Two GitHub repositories provide all the functionality:
  • cloudinary_flutter contains all the functionality required to deliver Cloudinary images using the dedicated CldImageWidget. All the Cloudinary Flutter functionality is installed by adding the cloudinary_flutter package as a dependency.
  • cloudinary_url_gen contains the functionality required to create delivery URLs for your Cloudinary assets based on the configuration and transformation actions that you specify. All the Cloudinary Dart functionality is installed by adding the cloudinary_url_gen package as a dependency.

Configure

The Cloudinary class is the main entry point for using the library. Your cloud_name is required to create an instance of this class and can be found in the Dashboard of the Cloudinary Console.

Here's an example of setting up a Cloudinary instance in your Flutter application:

Set additional configuration parameters

In addition to your cloud name, you can define a number of optional configuration parameters if relevant.

For example, set the secure optional configuration parameter to true:

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.

Configuration video tutorial

Watch this video tutorial to see how to install and configure the Flutter SDK:

This video is brought to you by Cloudinary's video player - embed your own!
Use the controls to set the playback speed, navigate to chapters of interest and select subtitles in your preferred language.

Use

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

  • 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.

Note
The Flutter SDK allows you to transform and deliver assets that are already in your Cloudinary repository. See Flutter image and video upload for ways to upload assets to Cloudinary.

Quick example: Image transformation

Here's a simple example for creating a Flutter widget that transforms and delivers a Cloudinary image, including a resize transformation, using the Flutter SDK:

Image example

Learn more about transformations

Quick example: Video transformation

Here is a simple example for generating a Cloudinary video URL, including a resize transformation with boomerang and vignette effects, using the Flutter SDK:

Note
Most transformations can be passed as parameters using Cloudinary's new action based syntax with enhanced code autocomplete. Transformations that aren't yet supported for the new syntax can still be implemented by passing them directly as strings via the ..addTransformation() method of the Flutter SDK.

For more information about the Flutter SDK syntax, see Syntax overview.

Learn more about transformations

Sample projects

Use the example code at pub.dev to quickly get a simple app working for delivering assets that are already in your Cloudinary repository.

Related topics

✔️ Feedback sent!

Rate this page: