Working with images
Learn about Cloudpress’ support for images and how you can control things like image compression, file names, etc.
Introduction
Cloudpress support exporting images from Google Docs and Notion to your CMS. Cloudpress will automatically upload the image to your CMS’s asset library, and reference the uploaded image in the exported content.
This document discusses how Cloudpress exports images and how it determines things like the image file name, alt text, etc. We’ll also look at how you can override the default behaviour with a feature of Cloudpress called processing directives. Finally, we’ll look at how you can enable image compression.
CMS image text support
Before we dive into the specifics, it is important to note that not all CMSs support image texts such as alt text, title, and caption. All the information in this document depends on the support of the various image texts as per your CMS.
In other words, even if Notion allows you to add an image caption, if your CMS does not support image captions, Cloudpress cannot export an image caption.
The table below summarises the support across all the CMSs.
| CMS content type | alt support | title support | caption support |
|---|---|---|---|
| Contentful (Long Text) | - | ||
| Contentful (Rich Text) | - | - | - |
| Kentico | - | - | - |
| Sanity | - | - | - |
| Webflow | |||
| WordPress (Gutenberg) | |||
| WordPress (Classic) | - |
How Cloudpress works with images
Cloudpress uploads images from your document to your CMS and does its best to attemp to set the correct filename, alt text, title, and caption. The exact behaviour depends on whether you use Google Docs or Notion.
Not all CMSs support image alt text and captions. Refer to the table in the CMS image text support section of this document.
Overriding the default behaviour
You can override the default behaviour of Cloudpress and specify specific values for the image file name, alt text, title, and caption by using the @@image processing directive.
Please review the documentation of the @@image processing directive for more information and examples.
Image compression and resizing
Optimizing images is crucial for modern websites. Not only does it significantly reduce page load times, ensuring a smoother user experience, but it also improves SEO rankings and reduces bandwidth costs. With the rise in mobile browsing, where data and speed are paramount, utilizing features like image compression, conversion to the efficient WebP format, and maintaining appropriate image dimensions becomes essential.
Cloudpress allows you to apply these optimizations when exporting images to your CMS automatically.
Enabling image optimizations for your CMS connection
Enable image optimization can be done on a per-connection level. Go to the Connections page and select the CMS connection you want to enable image optimizations for.
By default, image optimization is disabled. Enable optimization with the Enable image optimization toggle.
When image optimization is enabled, Cloudpress will automatically compress all your images before uploading them to your CMS. Cloudpress also allows you to configure additional settings.
The Image format setting allows you to specify the format of the images. Keep original format will keep the images in their original file format. You can convert images to WebP by selecting the Convert to WebP option.
You can also enforce maximum image dimensions by specifying a maximum width and height. When specified, any image that exceeds the maximum width or height will be scaled down to fit in the maximum dimensions specified. Cloudpress will scale the image proportionally, ensuring your image maintains the original aspect ratio.