Programmable Media

Go 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 and code explorer.

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 SDK

Create a go.mod file in the directory where your Go program will be saved:

In a terminal in your Go environment, run the following code:

In a terminal, set your CLOUDINARY_URL environment variable.

Replace CLOUDINARY_URL=cloudinary://API_KEY:API_SECRET@CLOUD_NAME with the API environment variable copied from your product environment credentials:

  • On Mac or Linux:

  • On Windows:

  • When writing your own applications, follow your organization's policy on storing secrets and don't expose your API secret.
  • If you use a method that involves writing your environment variable to a file (e.g. dotenv), the file should be excluded from your version control system, so as not to expose it publicly.

In your project, create a new file called my_file.go. Copy and paste the following into this file:


2. Upload an image

Copy and paste this into my_file.go:

my_file.go (continued)

3. Get and use details of the image

Copy and paste this into my_file.go:

my_file.go (continued)

4. Transform the image

Copy and paste this into my_file.go:

my_file.go (continued)

5. Run your code

Copy and paste this into my_file.go:

my_file.go (continued)

In the terminal, run the following command:

The following original image is uploaded to your Cloudinary account, tagged appropriately and accessible via the URL shown below.

The transformed version of the image is accessible via the URL shown below.

Original image Original image
Transformed image Transformed image

View the completed code

See the code above in action using this code playground.

If you want to see the output:
  • Click Remix to Edit.
  • Copy your API Environment variable value (i.e., only the portion after the equal sign, cloudinary://<api_key:api_secret@cloud_name).
  • Paste it into the Glitch .env file as the Variable Value for CLOUDINARY_URL.
  • Click Logs at the bottom of the screen.

This code is also available in GitHub

Next steps

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

✔️ Feedback sent!

Rate this page: