Image Tools

Resize, crop, and transform images.

Overview

The Image Tools connector is a workflow-side utility for transforming image files: resizing, cropping, rotating, converting formats, generating thumbnails, and adjusting visual properties. It runs inside Spojit and does not call any external service.

Use it to prepare images for downstream systems with strict size or format requirements (product catalog uploads, email templates, marketplace listings) or to generate variants (thumbnails, web/print versions) from a single source.

What You Can Do

The image connector exposes these tools:

resize - Resize an image to specified dimensions, preserving or stretching aspect ratio.
crop - Crop to a rectangular region.
rotate - Rotate by a fixed angle.
flip - Flip horizontally or vertically.
convert - Convert between formats (JPEG, PNG, WebP, etc.).
compress - Reduce file size with quality control.
thumbnail - Generate a fixed-size thumbnail in one step.
grayscale - Convert to grayscale.
blur - Apply a Gaussian blur.
get-info - Read dimensions, format, and metadata without modifying the image.

Authentication and Setup

No connection or authentication is required. These tools are built into the platform and available in every workflow by default - just drop a Connector node onto the canvas and pick the tool you need.

Using in a Workflow

Add a Connector node, select Image Tools, and choose Direct Mode with the operation you need. Image data flows in via {{ step.imageBytes }} (typically Base64-encoded from an upstream FTP download or HTTP fetch) and out as the transformed bytes for the next step.

Tips

Run get-info first when you don't know the input dimensions - it's cheap and prevents wasteful resizes.
Use thumbnail instead of resize when you want a fixed-size square output - it crops and resizes in one pass.
Convert to WebP for storage and CDN delivery: typically 25-35% smaller than equivalent-quality JPEG.
For bulk catalog work, wrap the transform in a Loop with a Parallel block of 4-8 to process images concurrently.

Common Pitfalls

Aspect ratio surprises - resize with a single dimension stretches by default. Set both width and height, or use thumbnail, to preserve aspect ratio.
Re-encoding losses - Each JPEG round-trip degrades quality. Convert to PNG/WebP for intermediate steps if multiple transforms run in sequence.
Memory on huge inputs - 50MP+ source images can hit memory limits. Resize early in the pipeline.
EXIF orientation - Some phone photos rely on EXIF rotation flags. Apply rotate based on the EXIF data from get-info before cropping.

Common Use Cases

For technical API details and field specifications, see the Image Tools documentation.