> ## 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. # n8n Integration ## Overview [n8n](https://n8n.io/) is a workflow automation platform that enables you to connect apps and automate workflows. With its visual, node-based interface, you can build complex automations without extensive coding knowledge. n8n supports both cloud-hosted and self-hosted deployments, giving you flexibility in how you manage your automation infrastructure. The [Cloudinary n8n integration](https://n8n.io/integrations/cloudinary/) allows you to connect Cloudinary's capabilities with over a thousand apps, data sources, services, and n8n's built-in AI features. Using Cloudinary as the central source of truth for media files within your organization enables efficient management of large volumes of media. In your n8n workflows, you can use instances of the Cloudinary node to: * Upload assets * Update asset tags * Update asset metadata * Retrieve a cloud's tag list * Fetch structured metadata definitions ![Cloudinary n8n integration](https://cloudinary-res.cloudinary.com/image/upload/q_auto/f_auto/bo_1px_solid_grey/v1761305207/docs/n8n-cloudinary-flow.png "thumb: w_600,dpr_2, with_code:false, with_url:false, width:600, popup:true") ## n8n integration video tutorial This video tutorial demonstrates how to install and use the Cloudinary node in your n8n automation: 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.### Introduction {table:class=tutorial-bullets}| | | --- | --- | |{videotime:id=media :min=0 :sec=00 :player=cld} | Get started with the Cloudinary n8n integration. Learn how to install and use the Cloudinary node to automate media workflows in your n8n automations. | ### Finding and installing the Cloudinary node {table:class=tutorial-bullets}| | | --- | --- | |{videotime:id=media :min=0 :sec=04 :player=cld} | Start with a new n8n flow and search for Cloudinary in the nodes panel. Select the Cloudinary integration and click **Install node**. After installation completes, you'll see six available actions organized into three categories: Upload actions (upload from URL, upload from file data), Update asset actions (update tags, update structured metadata), and Admin actions (get tags, get metadata field definitions). | ### Setting up credentials {table:class=tutorial-bullets}| | | --- | --- | |{videotime:id=media :min=0 :sec=32 :player=cld} | Connect to your Cloudinary account by setting up credentials. Click **Create New Credential** and enter your Cloud Name, API Key, and API Secret from your [Cloudinary Console](https://console.cloudinary.com/app/settings/api-keys). Find your Cloud Name on the Dashboard and your API credentials in the API Keys page of the Console Settings. Once saved, these credentials can be reused for all future Cloudinary actions. | ### Uploading an asset from a URL {table:class=tutorial-bullets}| | | --- | --- | |{videotime:id=media :min=1 :sec=46 :player=cld} | Build your first flow by using a chat trigger to input an image URL, then add the Cloudinary **Upload an asset from URL** action. The credentials are automatically applied, and you can pull the URL from the chat input. Configure the resource type (image) and delivery type (upload for public assets), then execute the step to upload the image to your Cloudinary Media Library. | ### Adding tags to assets {table:class=tutorial-bullets}| | | --- | --- | |{videotime:id=media :min=3 :sec=04 :player=cld} | Add tags to your uploaded assets using the **Update asset tags** action. Use the public ID, type, and resource type returned from the upload step to identify the asset, then specify the tags you want to add (like "dog", "cute dog", and "puppy"). Execute the step and verify the tags appear in the asset metadata in your Media Library. | ### Setting structured metadata {table:class=tutorial-bullets}| | | --- | --- | |{videotime:id=media :min=4 :sec=11 :player=cld} | Apply structured metadata to your assets with the **Update asset structured metadata** action. Use the same asset identifiers (public ID, resource type, type) and provide metadata as JSON. For example, set a "name" field to "Ruff" and a "category" field to "mammal". For single selection lists, use the external ID of the list value. | ### Discovering metadata field definitions {table:class=tutorial-bullets}| | | --- | --- | |{videotime:id=media :min=5 :sec=24 :player=cld} | Use the **Get metadata fields definitions** action to discover what metadata is configured in your account. This action requires no configuration—simply execute it to see all metadata types, their external IDs, labels, and other properties. This is helpful for understanding what metadata fields are available for your workflows. | ### Retrieving tags by resource type {table:class=tutorial-bullets}| | | --- | --- | |{videotime:id=media :min=5 :sec=49 :player=cld} | List all tags applied to assets in your Media Library using the **Get tags for a resource type** action. Filter by resource type (like "image") and optionally use a prefix to narrow results (like "cute" to find "cute dog" and "cute cat"). Leave the prefix empty to see all tags, displayed in alphabetical order. | ### Uploading generated images from file data {table:class=tutorial-bullets}| | | --- | --- | |{videotime:id=media :min=6 :sec=38 :player=cld} | Upload images from other sources (like OpenAI image generation) using the **Upload an asset from file data** action. The fields are automatically populated from the previous step's output, so you can simply execute it to upload the generated image directly to your Cloudinary Media Library. | ### Next steps: Build your workflows {table:class=tutorial-bullets}| | | --- | --- | |{videotime:id=media :min=7 :sec=20 :player=cld} | Now it's your turn! You've learned how to install the Cloudinary node, configure credentials, and use six different actions to manage media assets. Consider how you can integrate Cloudinary into your own n8n workflows to automate media management, enhance images, organize assets, and connect with other services in your automation ecosystem. | ## Get started Before you install the Cloudinary node, make sure you have a Cloudinary account. You can start by [signing up](https://cloudinary.com/users/register_free) for a Free plan. When your requirements grow, you can upgrade to a [plan](https://cloudinary.com/pricing) that best fits your needs. Once you have your Cloudinary account, install the Cloudinary node from the nodes panel in n8n. Search for **Cloudinary** and click **Install node**. ![Cloudinary n8n integration](https://cloudinary-res.cloudinary.com/image/upload/q_auto/f_auto/bo_1px_solid_grey/v1761309238/docs/install_node.png "thumb: w_400,dpr_2, with_code:false, with_url:false, width:400, popup:true") ### Add credentials Connect the Cloudinary node to your Cloudinary product environment by adding a new credential. 1. From the Cloudinary node panel, select one of the actions and click the **Credential to connect with** field. 1. Click **Create new credential**. 1. In the **Cloudinary account** dialog, enter your Cloud Name, API Key and API Secret. > **TIP**: Find your product environment's Cloud Name on the [Dashboard](https://console.cloudinary.com/app/home/dashboard) and your API Key and Secret in the [API Keys](https://console.cloudinary.com/app/settings/api-keys) page of the Console Settings. 1. Save the settings. You can now use these credentials for other Cloudinary actions in your automations. > **Learn more**: > > * Find out more about the [Cloudinary n8n integration](https://n8n.io/integrations/cloudinary/). > * Explore the [n8n documentation](https://docs.n8n.io/). ## Cloudinary Professional Services configuration support The n8n integration {variable:platformLabel} is part of Cloudinary's [**Standard**](integrations#standard_integrations) Professional Services integration configuration package. If you need assistance setting up this integration and you're on an Enterprise plan with a professional services package in your contract, Cloudinary's professional services can help you set it up as part of your contracted package. **Learn more: [Cloudinary Professional Services packages](integrations#cloudinary_professional_services_packages)** > **NOTE**: The Standard Professional Services integration configuration package includes support for the Cloudinary node but doesn't cover other aspects of your n8n workflows.