> ## Documentation Index
> This page relates to Cloudinary Integrations. Fetch the complete documentation index for all Cloudinary Integrations at: https://cloudinary.com/documentation/llms-integrations.txt?referrer=docpage and then use it to discover all relevant pages before exploring further.
> If your task extends beyond this product, fetch the top-level index covering all Cloudinary products and topics at: https://cloudinary.com/documentation/llms.txt?referrer=docpage

# CI HUB Cloudinary Connector


[new-permissions-link]: dam_admin_permissions
[old-permission-link]: dam_admin_users_groups#role_based_permissions

  
  

The CI HUB Cloudinary connector lets you access, edit, and sync your Cloudinary assets directly from the creative and productivity tools you use every day, such as Adobe Creative Cloud, Microsoft 365, and Google Workspace.

> **INFO**: The CI HUB-Cloudinary integration described here was developed according to Cloudinary's best practices and has been reviewed by the Cloudinary technical team. 

However, the integration is not maintained by Cloudinary. For all updates or questions related to this integration, please contact [CI HUB support](https://support.ci-hub.com/).

## Overview

CI HUB develops connectors between digital asset management systems and popular creative, productivity, and work management applications. With the CI HUB Cloudinary connector, you can work with your Cloudinary assets without leaving the application you're working in.

Use the connector to:

* Bring Cloudinary assets directly into your working platform, then make edits, changes, and designs, and push them back to your Cloudinary Media Library, including thumbnails, versioning, structured metadata, and tags.
* Sync and streamline asset workflows between Cloudinary and third-party platforms.
* Manage your Cloudinary assets from within your day-to-day tools.
* Maintain Cloudinary as the single source of truth for all your digital assets.

The connector is available for:

* **Creative tools**: Adobe Creative Cloud (InDesign, Photoshop, Illustrator, Premiere Pro), Adobe Express, Canva, Sketch
* **Productivity tools**: Microsoft 365 (PowerPoint, Excel, Word), Google Workspace (Sheets, Slides, Docs)

> **NOTE**: For Salesforce, Figma, and WordPress, we recommend using the Cloudinary-built [Salesforce](salesforce_integration), [Figma](figma_integration), and [WordPress](wordpress_integration) integrations.

### Permissions

The assets that users can see and manage through the CI HUB connector are based on their Cloudinary user permissions:

* If your product environment uses Cloudinary's granular Roles and Permissions model, each user sees only the assets their permissions allow.
* If your product environment uses the legacy permissions model, all users see all assets.
To find out whether your account uses the granular Roles and Permissions system, and for more information about it, see [Roles and Permissions][new-permissions-link]. For details on the legacy permissions model, see [Role-based permissions][old-permission-link].

## Prerequisites

* Make sure you have a Cloudinary account. If you don't have one yet, [sign up](https://cloudinary.com/users/register_free) for a Free plan.

* The CI HUB connector is licensed separately by CI HUB and is available with all Cloudinary plans. Sign up for a CI HUB plan or [free trial](https://ci-hub.com/start-free-trial) (a 30-day free trial is available). For pricing details, see [CI HUB pricing](https://ci-hub.com/).

## Installation

1. Install the connector in your application, as described in the [CI HUB getting started guide](https://ci-hub.com/get-started). The Cloudinary connector is supported in CI HUB Connector Professional and CI HUB Brand Connector.
2. Add the CI HUB connector to your platform as an extension, following your platform's own instructions for adding extensions (see the [CI HUB Help Center](https://support.ci-hub.com/getting-started) for platform-specific instructions).
3. Open the CI HUB panel in your application and select Cloudinary as your asset source.

  
    
    Add Cloudinary as a source
  
  
    
    Select Cloudinary as a source
  

4. In the **OAuth Application Login** page, enter your Cloudinary email and password, and click **LOG IN**. ![Authentication - Log in](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/v1750858219/docs/Figma/new_oauth.png "thumb: w_400,dpr_2, with_code:false, with_url:false, width:400, popup:true")

1. From the drop-down list in the **An application requests access to your data!** page, select the cloud name for the product environment you want to connect (find your product environment's **Cloud Name** on the [Dashboard](https://console.cloudinary.com/app/home/dashboard)). ![Authentication - Product environment selection](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/v1750859136/docs/Figma/oauth_cloud_select.png "thumb: w_400,dpr_2, with_code:false, with_url:false, width:400, popup:true")5. Choose the additional data the connector can access (you can reconnect later to change your selection):
   * **Include metadata and versions**: Retrieves detailed EXIF, XMP, and IPTC metadata and asset version history, shown in the connector's [detail view](#view_details). For more information, see [Image metadata](dam_admin_structured_metadata#view_and_add_metadata_values) and [Asset versions](dam_manage_asset_protection#managing_asset_versions).
   * **Include restricted assets**: Resolves thumbnail and download URLs for restricted assets. For more information, see [Access-controlled assets](dam_manage_asset_protection#access_control_modes).The panel then connects to your product environment.

## How to use

Once connected, the CI HUB panel gives you a file-browser view of your Cloudinary Media Library from inside your application. From there you can search, filter, and preview assets, insert them into your document or design, upload new files, and push edits back to Cloudinary, all without switching windows.

> **NOTE**: This walkthrough shows the CI HUB Connector Professional panel. CI HUB Brand Connector uses the same panel and steps, though available options may vary depending on your license.

### Browse and find assets

#### Manage folders

The panel opens at the root of your Media Library and shows your folders. 

* View and select folders from the main area or the breadcrumb dropdown.
* From the **Navigation** toolbar: 
  * Bookmark a folder for quick access
  * Add a folder
  * Search for a folder

![CI HUB Connector - Folder view](https://cloudinary-res.cloudinary.com/image/upload/q_auto/bo_1px_solid_grey/f_auto/docs/integrations/cihub_folders.png "thumb: w_300,dpr_2, with_code:false, with_url:false, width:300, popup:true")

#### Switch between list and grid view

Browse assets in whichever format you prefer.

![CI HUB Connector - List and grid view](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/docs/integrations/cihub_list_view.png "thumb: w_300,dpr_2, with_code:false, with_url:false, width:300, popup:true")



#### Find and view assets and their details

Click a folder to view the assets it contains, or filter by structured metadata fields set within Cloudinary. Once you've found your asset, click to view it.

Click **Detail view** to see its metadata and other details. Use **Next asset** and **Previous asset** to step through assets one at a time.

  
    
    Assets in a folder
  
  
    
    Asset details
  

To choose which fields to display, click **Settings** in the bottom panel and select the columns you want from the dropdown. The metadata and version fields available here depend on whether you selected **Include metadata and versions** in [step 6 of the installation](#cihub_data_access).

![CI HUB Connector - Choose detail fields](https://cloudinary-res.cloudinary.com/image/upload/c_crop,w_600,h_700,g_south/f_auto/q_auto/bo_1px_solid_grey/docs/integrations/cihub_set_details.png "thumb: w_400,dpr_2, with_code:false, with_url:false, width:400, popup:true")

### Insert and manage assets

#### Insert one or more assets into your project

To insert a single asset, select an asset and click **Use file** in the bottom panel.

To insert several assets at once, select **Multiple selection**, choose the assets you want, then click **Use file**.

In both cases, you can then choose whether to insert the original asset or a **Rendition** created by applying one of your Cloudinary transformation templates.

  
    
    Insert an asset
  
  
    
    Select multiple assets
  

#### Upload a file to the current folder

Click **Add file** to upload a file to the current folder in Cloudinary. Confirm the target folder, then optionally choose the file to upload from your application or local file system, set the file name and upload preset, and add tags.

![CI HUB Connector - Upload a file](https://cloudinary-res.cloudinary.com/image/upload/c_crop,w_600,h_830,g_south,y_280/q_auto/f_auto/bo_1px_solid_grey/docs/integrations/cihub_upload.png "thumb: w_300,dpr_2, with_code:false, with_url:false, width:300, popup:true")

#### Open the asset in Cloudinary

Click **Open in browser** in the bottom panel to view the asset in your Cloudinary Media Library.

![CI HUB Connector - Bottom nav](https://cloudinary-res.cloudinary.com/image/upload/c_crop,w_600,h_90,g_south,y_190/q_auto/f_auto/bo_1px_solid_grey/docs/integrations/cihub_upload.png "thumb: w_300,dpr_2, with_code:false, with_url:false, width:300, popup:true")

#### Update a file

Click **Update file** in the bottom panel to push a new version of the asset to Cloudinary, taking the update either from within your application or from your local file system.

#### Delete an asset

Select an asset and click **Delete asset** to remove it from your Cloudinary Media Library.

### Manage your connection

#### View and repair your connection

To diagnose your asset connection to Cloudinary, click **External Content Panel** from the **Navigation** toolbar. You'll see how many assets are without an original rendition and how many unlinked assets were found.

Click either **...assets without original rendition** or **...unlinked assets found** to open a list of those. Click **Relink** to relink your local asset to Cloudinary.

  
    
    Connection status
  
  
    
    Relink an asset
  

## CI HUB in InDesign video tutorial

In this video tutorial, you'll learn how to use the CI HUB interface to import an image from Cloudinary into InDesign, apply an image overlay, and upload the saved .indd file back to Cloudinary.

  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.

## Get the connector

* To learn more about CI HUB and get started, visit the [CI HUB website](https://ci-hub.com/).

* For step-by-step installation instructions, see the [CI HUB getting started guide](https://ci-hub.com/get-started).

* For video walkthroughs, see the [CI HUB video tutorials](https://ci-hub.com/video-tutorials).

* For support, visit the [CI HUB support documentation](https://support.ci-hub.com/).

## Cloudinary Professional Services configuration support
The CI HUB connector is part of Cloudinary's [**Standard**](integrations#standard_integrations) Professional Services integration configuration package. 

If you need assistance setting up this integration:

* The CI HUB integration partner/third-party support includes configuration support.
* If you're on an Enterprise plan with a professional services package in your contract, Cloudinary's professional services can also help you set it up as part of your contracted package.

**Learn more: [Cloudinary Professional Services packages](integrations#cloudinary_professional_services_packages)**