Documentation Index

Fetch the complete documentation index at: https://cloudinary.com/documentation/llms.txt

Use this file to discover all available pages before exploring further.

Image & Video APIs

Programmatic upload (video tutorial)

Last updated: Jul-22-2026

Overview

Would you rather upload programmatically than use the UI? This tutorial gives an overview of uploading assets to Cloudinary programmatically with a single function call, using the CLI or a Cloudinary SDK in the language of your choice.

You'll see how the upload call works with local files, remote URLs, or user uploads, and how the JSON response gives you useful information like image stats, delivery URLs, and transformation options. Learn more in the Upload guide, or follow the Upload programmatically tutorial for a detailed walkthrough.

Video tutorial


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.

Tutorial contents

This tutorial presents the following topics. Click a timestamp to jump to that part of the video.

Beyond the upload widget

Jump to this spot in the video  0:04 Uploading with the Upload widget is easy if you're comfortable clicking around on a desktop. But what if you'd rather upload programmatically?

One function call

Jump to this spot in the video  0:14 If you're comfortable using the command line interface or coding tools, programmatic uploads can save hours on a big project with just one function call.

Set up the CLI or an SDK

Jump to this spot in the video  0:22 Set up the Cloudinary CLI or use a Cloudinary SDK to build this functionality into your project in whatever language you're using.

Upload from local files, URLs, or user uploads

Jump to this spot in the video  0:30 This upload call works with local files, remote URLs, or user uploads in your project.

A useful JSON response

Jump to this spot in the video  0:35 The JSON response gives you useful info, including image stats, delivery info, transformation options, and more.

Ready for transformations and delivery

Jump to this spot in the video  0:42 This is just getting started. With a simple upload, your assets are in the cloud, ready for transformations, optimizations, and global delivery.

Keep learning

Related topics

If you like this, you might also like...

 

Cloudinary Academy

 

Check out the Cloudinary Academy for free self-paced Cloudinary courses on a variety of developer or DAM topics, or register for formal instructor-led courses, either virtual or on-site.

 

✔️ Feedback sent!

Rate this page:

one star two stars three stars four stars five stars