Adjust Image Settings in Content Workflow

There are various options for adjusting images in Content Workflow. Mastering these settings can empower content creators to enhance the appearance and functionality of images.

How to Access Image Settings

  1. Navigate to Content Workflow.
  2. Create a new item or edit an existing one. 
  3. Upload or Select an Inline Image (An image added to a text field and not an asset field).
  4. Hover over the image and selectScreenshot 2024-06-26 at 3.23.17 PM.png [CW] Image settings icon.png
  5. The image settings interface will appear down the left-hand side of the page. [CW] Image Settings Menu.png
  6. There are 5 editable settings that you can customize:

Image Setting Options

Alt text

Alt text should be set for each image you upload intended for use on the web. It is good for both SEO and accessibility, allowing screen readers to describe the image in question. With that in mind, the alt text should visually describe the image in a simple and succinct manner, without any flourish that might confuse visually impaired users, such as URLs or call-to-actions like "Click here."[CW] Alt Text.png

A bad example:

Click here to find out more about mountaineering

A good example:

A person reaching a mountain summit at sunrise

Tip: Alt text can also be set when viewing an image from your Files & media library.


Think of crop as a window. When you change the crop, you don't delete the rest of the image; you just choose a part of it to be visible. We provide some common aspect ratios to get you started. For example, "Square" is useful for profile images or social media posts. If, however, you have a specific ratio you need an image to be, choose "Custom" and enter your values.


Tip: Crop doesn't use pixel values—in fact, it doesn't use any value. It's just a ratio. If you want to specify an image's physical dimension, see Dimensions below.

[CW] Crop Menu.png


When cropping an image, focus helps you choose which area is visible.[CW] Focus Menu.png

Crop direction

Use crop direction to position the image crop to your preference. For example, choosing "Centre" will always keep the center of the image visible and hide the surrounding areas. "Top-left" will always keep the top-left of the image visible, and so on.


Use zoom to focus on a specific area, based on the crop direction that has been set. The maximum zoom is 400%.


Here you can provide precise dimensions in pixels, for example, if you have strict rules around images being no wider than 2,000px. In our editor, we always honour the aspect ratio specified in Crop. This is to prevent authors from accidentally stretching images by providing both width and height values.

  • Auto - the image will maintain its maximum physical size (taking crop into account).
  • Width/Height - set a max width or height. Enter a width value and the height will be calculated automatically, and vice-versa.[CW] Dimensions Menu.png

Entering a larger value than the original image will distort the image. It is recommended that you specify dimensions that are smaller than the original image.

Tip: If using a square crop, entering a value for width or height will achieve the same result.


Enable "auto-compress" to reduce the file size of your image using best-effort techniques to maintain visual quality. Leave disabled if the results aren't as expected.[CW] Quality Menu.png


Q: How are images compressed by default?

Content Workflow compresses images in our content editor to improve app performance. This compression is not applied at the destination (unless enabled in Quality), so the image you upload to Content Workflow is the image you get out, taking into consideration any cropping and dimensions that have been applied.


Note: Images and files uploaded before 15 March 2021 will not have their respective metadata available, including dimensions. Setting custom dimensions is still possible, but default values will not be visible.


Was this article helpful?

0 out of 0 found this helpful

We're sorry to hear that!

Find out more in our community

Have more questions? Find out more in our community