Image Processing Tool Icon

Image Processing

Last modified: July 01, 2022

Use Image Processing to perform a number of actions on images. The tool lets you align, threshold, scale, and crop images. You can also balance their brightness and convert them to grayscale.

This tool is part of Alteryx Intelligence Suite. Intelligence Suite requires a separate license and add-on installer to Designer. After you install Designer, install Intelligence Suite and start your free trial.

Tool Components

Image Processing has 2 anchors:

  • Input anchor: Use the input anchor to connect to the data that contains the images you want to process.

  • Output anchor: Use the output anchor to pass processed images downstream.

    • Note—The "image_processed" column contains your processed images.

Configure the Tool

  1. Add Image Processing to the canvas.

  2. Use the input anchor to connect the tool to the data that contains the images you want to process.

  3. From the Image field, select the images you want to process.

  4. Select the Add Step button to open a dropdown that allows you to add any of these steps:

    The tool processes each step in order from top to bottom. You can drag steps you've already added to reorder them. Select the trash-can icons to remove steps.

    • Alignment

    • Thresholding

    • Scale

    • Crop

    • Brightness Balance

    • Grayscale

    • OCR Optimization

  5. Run the workflow


Each step of the image processing has advanced configuration options.


Using the Custom option, you can use the slider to specify the degree and direction of the rotation that the tool applies to images. Select the refresh icon to reset the slider.


Set a threshold to convert images to a binary, like black and white, for each channel.

We provide several algorithms you can use to threshold your images. In most cases, we recommend that you use Adaptive Gaussian for images of text, like scanned pages of a book, and Binary for other images, like photographs. For a more in-depth discussion of thresholding, visit OpenCV's thresholding documentation.

Note—Adaptive thresholding methods require images to be single channel (in other words, grayscale). If you don't have a Grayscale step preceding a Thresholding step, we perform grayscaling for you, but we don't add a grayscale step in the Configuration window.


Resize images.

Choose how much bigger or smaller you want to make the images. You can specify the width and height in pixels or by percentage relative to the size of the original images.

You can also choose to lock the aspect ratio of your images, which means that their proportions won't change even if you change the height or width.


Remove parts of images.

To crop an image, choose how much of the image you want to keep. You can make that selection by indicating the width and height in pixels or percentages. Then use the anchor grid to select what portion of the image you want to keep after cropping.

Brightness Balance

Automatically or manually adjust the brightness of images.

Convert multi-channel images to single channel. The Auto option allows the tool to automatically balance the brightness of images. If you select the Custom option, you can use the slider specify how light or dark you want the image to be.


Convert multi-channel images to single channel. You don't have to configure anything.

OCR Optimization

Optimize your scanned PDF files for Optical Character Recognition (OCR). Only use OCR Optimization on noisy documents with scanning artifacts, printed background texture, and non-white backgrounds. We don't recommend OCR Optimization for clean documents.

OCR Optimization has 3 modes:

  • Auto: The tool automatically decides whether it applies Heavy or Light processing on a per-document basis.
  • Heavy: Use for denser and noisier documents.
  • Light: Use for relatively clean documents.

If your document has a non-white background, select Some Text Has Non-White Background. For example, select this option if your document has white text on a blue background.

Was This Page Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support. Can't submit this form? Email us.