Programmable Media

.NET quick start

Last updated: Oct-31-2023

This quick start is intended to let you quickly try using several common Cloudinary features. It doesn't necessarily employ coding best practices and the code you create here isn't intended for production.

You can perform this quick start in a code sandbox or in a clean project in the dev environment of your choice.

You can also view the completed code of this quick start in a GitHub repo.

If you aren't familiar with Cloudinary, you may want to first take a look at the Developer get started guide for a high-level overview of integrating Cloudinary into your code, and an introduction to the main concepts.

You may also find our Glossary helpful to understand Cloudinary-specific terminology.


To perform this quick start, you'll need:

1. Set up and configure the library

Add CloudinaryDotNet and using the Nuget Package Manager or if using the Package Manager Console, run:

Then, in your project, create a file called .env and add the following line with your Cloudinary environment variable:


When writing your own applications, follow your organization's policy on storing secrets and don't expose your API secret.

In your code, include the following CloudinaryDotNet libraries as well as the library in your project.

You can then load your Cloudinary credentials from your .env file as shown below. Copy and paste the following code into your Program.cs file:


2. Upload an image

Copy and paste the following code into your Program.cs file:

Program.cs (continued)

3. Get details of the image

Program.cs (continued)

4. Transform the uploaded image

Program.cs (continued)

5. Run your code

Run your code by clicking the Run button in Visual Studio or .NET fiddle.

You can use the returned image tag to display the image on your website. For now, copy and paste the URL to see the transformed image in the browser:

Transformed cld-sample image

View the completed code

You can find the full code example for this on GitHub.

Next steps

  • Learn more about the .NET SDK by visiting the other pages in this SDK guide.
  • Get comprehensive details about Cloudinary features and capabilities:

✔️ Feedback sent!

Rate this page: