WordPress Plugin

With the Cloudinary WordPress plugin, you can upload and manage your images in Cloudinary directly from your WordPress interface. The plugin also supports automated (single-click) migration of all images from your existing posts to Cloudinary.

Once your WordPress images are stored in Cloudinary, you can take advantage of Cloudinary's transformation, optimization, and responsive image features as well as fast CDN delivery.

• Where to download the plugin?
• When is a new version of the plugin released?
• How to link my Cloudinary account to WordPress?
• How to synchronize my WordPress Media Library?
• What are the asset sync statuses displayed in my Media Library?
• How to apply transformations to my resources?
• How to make my images responsive?
• Can I delete assets in my Cloudinary Media Library?
• How to generate a system report?
• How to contact Cloudinary support if I have an issue?
• Useful Links

Where to download the plugin?

You can download the plugin in the WordPress Marketplace. In case you would like to install the plugin manually, you can find the plugin in the Cloudinary GitHub.

When is a new version of the plugin released?

Usually, a new version is released during the first week of each month, however, a release can be delayed in case of issues detected during the QA. 

In case an issue needs a hotfix, a hotfix can be done out of the release schedule.

Each time, the plugin is released, the WordPress changelog and the Github release page are updated with the new features and issues fixed by this release.

How to link my Cloudinary account to WordPress?

When you install the Cloudinary plugin (v3 and above), you will get a wizard to connect and configure the plugin, you will need to enter the Connection string on the 2nd step of this wizard:

If you'd like to change your credentials, you can go in your General Settings under the Cloudinary plugin and re-launch the wizard where you will be able to switch the Connection string

After specifying your Connection string, please click on Next.

How to synchronize my WordPress Media Library?

In your WordPress menu, under the Cloudinary plugin, you can access the Sync Settings by clicking on the Media Settings section then the Sync tab in order to configure how to synchronize your WordPress Media Libary. 

Sync Method

When you install the plugin, the Sync Method will be set to Auto Sync by default.

Auto Sync: After the plugin is installed, all your assets will be automatically synchronized to your Cloudinary Media Library. When adding new assets to your WordPress Media Library, those assets will also be synchronized to your Cloudinary Media Library 

Manual Sync: When adding new assets to your WordPress Media Library, in order to synchronize your assets to your Cloudinary Media Library, you can: 

• Hover a specific asset you would like to synchronize and click on Sync and deliver from Cloudinary.
• Select a list of assets you would like to synchronize then select the Sync with Cloudinary bulk action and click on Apply.

Cloudinary Folder Path

This is a folder in your Cloudinary Media Library where the assets from your WordPress Media Library will be synced with.

Storage

When you install the plugin, the Storage will be set to Cloudinary and WordPress by default.

• Cloudinary and WordPress - This setting will store all assets in both Cloudinary and WordPress local storage. With this setting, if there are any issues with your Cloudinary account or you choose to deactivate the Cloudinary plugin, your assets will be delivered directly from WordPress storage with no issues.
• Cloudinary and WordPress (low resolution) - This setting will store the original full resolution assets with Cloudinary and a lower resolution compressed version in WordPress, saving space in your local storage. With this setting, if you deactivate the Cloudinary plugin, your assets will be delivered at a much lower resolution directly from WordPress storage.
• Cloudinary only - This setting will store all assets in Cloudinary only. With this setting enabled, you need to manually sync your media back to WordPress before deactivating the plugin.

Re-Sync

Deleting an asset or moving an asset to another folder in your Cloudinary Media Library may lead to broken links. On your WordPress Media Library, you can hover a specific asset you would like to re-synchronize and click on Re-sync to Cloudinary.

What are the asset sync statuses displayed in my Media Library?

• Indicates the asset is fully synced with Cloudinary; it exists in both WordPress and Cloudinary and will be delivered using a Cloudinary delivery URL.
• Indicates the asset syncing with Cloudinary is in progress.
• Indicates the metadata and/or the breakpoints syncing with Cloudinary is in progress.
• Indicates the asset is not synced with Cloudinary. Any un-synced assets can be pushed manually. Hover over the relevant asset and select the Push to Cloudinary option. Alternatively, to sync all assets you can perform a bulk-sync.
• Indicates there was a problem syncing to Cloudinary. Hovering over the icon will show a message explaining the error. This will most likely be due to a file size limitation or an incompatible file type. Please refer to your package limitation for more information on this.

How to apply transformations to my resources?

You can apply transformations to images and videos at different levels:

• Global-level transformations
• Taxonomy-level transformations
• Individual-level transformations

Global-level transformations

In your WordPress menu, under the Cloudinary plugin, you can access the Transformations Settings by clicking on the Media Settings section then the Media Display tab in order to select your delivery settings for both videos and images.

For images, you can:

• Select a specific format to deliver your images or let the Cloudinary algorithm chose the best format to deliver by selecting the Auto setting.
• Select a specific compression quality to deliver your images or let the Cloudinary algorithm chose the best compression quality to deliver by selecting the Auto setting.
• Add a transformation string to add to all your images.

For videos, you can:

• Select the video player you would like to play your videos with between the Cloudinary Player and the WordPress Player.
• Only for the Cloudinary Player, you can select different options:
  • Show controls in the player.
  • Autoplay the videos or not.
  • And if the videos will be repeated or not.
• Specify the bitrate the videos will be delivered with.
• Add a transformation string to add to all your videos.

For both videos and images, the best practice for the transformation string is to ensure this transformation string won’t edit the content of the media too significantly and therefore would not need to be overwritten. An example would be to add a watermark to all your media assets

Taxonomy-level transformations

Taxonomy level transformations are specific to a defined taxonomy, either a category or a tag

For both videos and images, you can add a transformation string that will be applied to all the assets on a page or a post where a category or a tag is added.

If you have multiple categories or tags, you can configure the order in which the taxonomy level transformations should be applied.

Individual-level transformations

There are now 2 options to add an individual transformation.

• In your WordPress Media Library, you should see a new column named Transformations where you should see the Add Transformations link or a transformation if you imported and transform an image using the 2nd option:
• In a post or a page, add an image/video from your Media Library. When selecting this option, you should see a 3rd tab named Cloudinary, that will show your Cloudinary Media Library. On the top right corner of the asset, you would like to add, you can click on Manage that will redirect you to the Cloudinary Editing page where you can add transformations to your asset. To access the transformed asset, you have to click on the Insert button and then Select.

How to make my images responsive?

In your WordPress menu, under the Cloudinary plugin, you can access the Transformations Settings by clicking on the Media Settings section then the Media Display tab in order to enable responsive breakpoints. 

After enabling the responsive breakpoints, you will have the options to: 

• Add a maximum number of breakpoints which represents the maximum number of images that can be generated when delivering responsive images.
• Specify the minimum byte step between 2 breakpoints.
• Add a minimum and maximum width limit to avoid creating images that will be never used.

Can I delete assets in my Cloudinary Media Library?

We do not recommend deleting any assets inside your Cloudinary Media Library neither moving assets to a different folder as this may break the links on your production website. In case you did one of these actions, you can re-sync your asset from your WordPress Media Library.

How to generate a system report?

In your WordPress menu, under the Cloudinary plugin, you can access the Need Help? section then you can select the System Report icon in order to generate the report:

You can also add specific images to your report if needed by hovering a specific asset you would like to synchronize and clicking on Add to Cloudinary report: 

How to contact Cloudinary support if I have an issue?

You can contact the Support team by:

• Open a request with us at support.cloudinary.com
• Creating a forum post in the WordPress Marketplace Support section.
• Sending an email to support@cloudinary.com.
• Creating a forum post in the Cloudinary Support forum.

Useful Links

• WordPress Marketplace: https://en-gb.wordpress.org/plugins/cloudinary-image-management-and-manipulation-in-the-cloud-cdn/#developers
• WordPress Marketplace Support: https://wordpress.org/support/plugin/cloudinary-image-management-and-manipulation-in-the-cloud-cdn/
• Documentation: https://cloudinary.com/documentation/wordpress_integration
• GitHub repository: https://github.com/cloudinary/cloudinary_wordpress