The Cloudinary .NET SDK allows you to quickly and easily integrate your application with Cloudinary. Effortlessly optimize, transform, upload and manage your cloud's assets.

This Readme provides basic installation and usage information. For the complete documentation, see the .NET SDK Guide.

• Key Features
• Version Support
• Installation
• Usage
  • Setup
  • Transform and Optimize Assets
  • Upload
  • Error handling
  • Code Samples
• Documentation for AI coding agents
• Contributions
• Get Help
• About Cloudinary
• Additional Resources
• Licence

• Transform and optimize assets.
• Generate image and video tags.
• Asset Management.
• Secure URLs.

CloudinaryDotNet is available as NuGet package CloudinaryDotNet

Install using Package Manager:

PM> Install-Package CloudinaryDotNet

Or using the .NET CLI:

dotnet add package CloudinaryDotNet

using CloudinaryDotNet;
using CloudinaryDotNet.Actions;

var cloudinary = new Cloudinary();   // reads the CLOUDINARY_URL environment variable
cloudinary.Api.Secure = true;        // generate https:// URLs

Note that Api.Secure defaults to false, so set it unless you specifically want http:// URLs.

• See full documentation.

var url = cloudinary.Api.UrlImgUp.Transform(new Transformation().Width(100).Height(150).Crop("fill")).BuildUrl("sample.jpg")

• See full documentation.
• Learn more about configuring your uploads with upload presets.

var uploadParams = new ImageUploadParams()
{
    File = new FileDescription(@"c:\mypicture.jpg")
};

var uploadResult = cloudinary.Upload(uploadParams);

Cloudinary API errors are returned, not thrown. Check Error on every result:

var uploadResult = await cloudinary.UploadAsync(uploadParams);

if (uploadResult.Error != null)
{
    Console.Error.WriteLine($"Upload failed ({(int)uploadResult.StatusCode}): {uploadResult.Error.Message}");
    return;
}

Console.WriteLine(uploadResult.SecureUrl);

A try/catch around an API call will not catch a Cloudinary error — only configuration and argument problems throw. See docs/troubleshoot-errors.md.

You can find our simple and ready-to-use samples projects, along with documentations in the samples folder.

Please consult with the README file, for usage and explanations.

Task-focused runnable examples live in examples/.

• See full documentation.
• To report a vulnerability, see SECURITY.md.

This package ships task documentation inside the NuGet package, so it always matches the version you have installed. If you are an AI coding agent — or you use one — point it there rather than at training data, which is frequently out of date for this SDK.

Locate the installed copy:

ROOT=$(dotnet nuget locals global-packages --list | awk '{print $2}')
ls "$ROOT"/cloudinarydotnet/*/docs

The same pages are browsable here: docs/ — covering configuration, upload, chunked video upload, signed browser uploads, image and video delivery, search and asset management, moderation, structured metadata, ASP.NET Core integration, and troubleshooting.

Agents contributing to this repository should read AGENTS.md instead.

• Ensure tests run locally (dotnet test CloudinaryDotNet.Tests/CloudinaryDotNet.Tests.csproj -c Release -f net8.0)
• Open a PR and ensure the CI build passes

See CONTRIBUTING.md for details.

If you run into an issue or have a question, you can either:

• Issues related to the SDK: Open a GitHub issue.
• Issues related to your account: Open a support ticket

Cloudinary is a powerful media API for websites and mobile apps alike, Cloudinary enables developers to efficiently manage, transform, optimize, and deliver images and videos through multiple CDNs. Ultimately, viewers enjoy responsive and personalized visual-media experiences—irrespective of the viewing device.

• Cloudinary Transformation and REST API References: Comprehensive references, including syntax and examples for all SDKs.
• MediaJams.dev: Bite-size use-case tutorials written by and for Cloudinary Developers
• DevJams: Cloudinary developer podcasts on YouTube.
• Cloudinary Academy: Free self-paced courses, instructor-led virtual courses, and on-site courses.
• Code Explorers and Feature Demos: A one-stop shop for all code explorers, Postman collections, and feature demos found in the docs.
• Cloudinary Roadmap: Your chance to follow, vote, or suggest what Cloudinary should develop next.
• Cloudinary Facebook Community: Learn from and offer help to other Cloudinary developers.
• Cloudinary Account Registration: Free Cloudinary account registration.
• Cloudinary Website: Learn about Cloudinary's products, partners, customers, pricing, and more.

Released under the MIT license.