Imgix

These are the Imgix actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• IMGIX_CLOSE_UPLOAD_SESSION

  Tool to close an Imgix Asset Manager upload session after the client uploads to the presigned URL. Use after uploading a file to expedite asset processing. Closing is strongly recommended by imgix.

• IMGIX_CREATE_IMGIX_SOURCE

  Tool to create and deploy a new imgix Source. Use when you need to add a new image source with deployment configuration for S3, Web Folder, Web Proxy, GCS, Azure, or S3-compatible storage. Requires source name and deployment details with type-specific credentials and settings.

• IMGIX_CREATE_UPLOAD_SESSION

  Tool to create an Imgix Asset Manager upload session and return a presigned URL for client-side upload. Use when you need to upload a new image to a storage-backed imgix Source without requiring external hosting. Client performs HTTP PUT of file bytes to the presigned URL, then calls IMGIX_CLOSE_UPLOAD_SESSION to finalize.

• IMGIX_GET_SOURCE

  Tool to retrieve details for a single imgix Source by its ID. Returns the source configuration including deployment status, type, and settings.

• IMGIX_GET_UPLOAD_SESSION_STATUS

  Tool to retrieve the status of an Imgix Asset Manager upload session. Use when you need to check the current state (PENDING/CLOSED/COMPLETE/CANCELED) of an upload session for polling or verification after client PUT and/or after closing.

• IMGIX_LIST_ASSETS

  Tool to retrieve a paginated list of assets in an imgix Source. Use when you need to list, filter, or search assets with cursor-based pagination and sorting.

• IMGIX_LIST_REPORTS

  Tool to retrieve a list of all available reports for your imgix account. Use when you need to access analytics and usage information. Reports are generated daily and retained for 90 days.

• IMGIX_UPDATE_SOURCE

  Tool to update an existing imgix Source. Use when you need to modify source name, deployment configuration, bucket settings, or other source attributes. Deployment changes trigger automatic redeployment.

• Adjust Image Brightness

  Tool to adjust image brightness. Use when you need to modify an image's brightness level (−100 to 100) by supplying your source domain and asset path.

• Adjust Image Contrast

  Tool to adjust image contrast. Use when you need to modify an image's contrast level (−100 to 100).

• Adjust Image DPI

  Tool to embed DPI (dots-per-inch) metadata for print output on an Imgix-rendered image. Use when preparing images for print to set accurate DPI. Supports JPEG and PNG only.

• Adjust Image Highlights

  Tool to adjust highlight tonal mapping (−100 to 0). Use when preserving detail in bright areas of an image.

• Blend Color Over Image

  Tool to blend a solid color over an image using CSS keyword or hex. Use when you need to apply color overlay transformations to an existing image URL.

• Blend Overlay

  Tool to overlay an image, text, or color onto a base image using imgix blending parameters. Use after specifying the base image URL and blend parameters to composite layers.

• Draw Image Border

  Tool to draw a border around an image. Use when you need to overlay a border without resizing.

• Force Aspect Ratio

  Tool to force a target aspect ratio on an Imgix image. Use when a specific W:H frame is needed after choosing fit=crop or fit=fill. Example: 'ar=16:9&fit=crop&w=800' yields a 16:9, 800px-wide URL.

• Imgix Auto Optimization

  Apply automatic image optimizations using imgix's auto parameter. Use this tool to automatically optimize images for web delivery. Common use cases: - Reduce file sizes with 'compress' for faster page loads - Auto-select modern formats (AVIF/WebP) with 'format' based on browser support - Enhance image quality with 'enhance' (adjusts brightness, contrast, saturation) - Remove red-eye from portrait photos with 'redeye' Multiple options can be combined (e.g.,

• Imgix Blend Align

  Tool to align the overlay relative to the base image when blending. Use after constructing a base Imgix URL to specify horizontal and vertical alignment (e.g., 'left,top').

• Imgix Blend X Position

  Position an overlay image horizontally on a base image using imgix's blend-x parameter. Use this tool when you need to place an overlay (image or color) at a specific horizontal offset from the left edge of the base image. This is useful for creating watermarks, badges, or composite images where precise positioning is required. Note: The blend-x parameter only affects image overlays. Color overlays always cover the entire image regardless of this setting.

• Imgix Mark Height

  Tool to set watermark height on an Imgix URL in pixels or as a ratio of the watermark source. Use when adjusting overlay height while preserving aspect ratio.

• Imgix Rotate

  Tool to rotate an image on Imgix. Use when you need to apply a counter-clockwise rotation (0–359°) with optional mode control.

• Imgix URL Expiration

  Tool to append an expiration parameter to an Imgix URL so it returns 404 after a given time. Use when you want the image URL to stop serving beyond a specific UNIX timestamp.

• IMGIX_ADD_ASSET_FROM_ORIGIN

  Tool to queue a path from your origin to be added to the Asset Manager. Imports the asset metadata without uploading the asset itself. Use when you need to register an existing origin-hosted file with imgix.

• IMGIX_CANCEL_UPLOAD_SESSION

  Tool to cancel an Imgix Asset Manager upload session. Use when you need to abort an in-progress or abandoned upload flow and clean up the session.

• IMGIX_CH

  Tool to opt in to Client Hints. Use when you want Imgix URLs to adapt based on browser headers (Width, DPR, Save-Data).

• IMGIX_CS

  Tool to set or strip output color space/profile on an Imgix image. Use when optimizing compatibility and file size (e.g., cs=strip for smaller metadata).

• IMGIX_DL

  Download an asset from an Imgix source with optional custom filename. Use this tool when you need to: - Download images or assets from an Imgix CDN source - Force a specific download filename (via 'dl' parameter) - Download assets with special character filenames (via 'dl64' parameter) The asset is fetched from the Imgix CDN and returned as a downloadable file reference. If neither 'dl' nor 'dl64' is specified, the original filename from the path is used.

• IMGIX_FIT

  Tool to control how an image fits target dimensions after resizing. Use when specifying width, height, and fit behavior.

• IMGIX_FM

  Tool to choose output file format for the rendered asset. Use after specifying the asset path when you need to convert its format.

• IMGIX_H

  Tool to set output image height in pixels or as a ratio of the source height. Use after constructing an Imgix URL to adjust only height.

• IMGIX_LIST_SOURCES

  Tool to list all Sources for an account. Use when you need to retrieve and paginate through sources with optional sorting and filtering.

• IMGIX_MARK_PAD

  Tool to set pixel padding between a watermark and the image edge or between tiled watermarks. Use after configuring watermark URL and alignment to adjust spacing precisely.

• IMGIX_MASK

  Tool to apply a mask to an image. Use when needing rounded corners, ellipse shapes, or image-based masks.

• IMGIX_MAX_H

  Constrain the maximum height of an imgix image. This tool applies fit=crop along with the max-h parameter to ensure images do not exceed the specified height. Ideal for vertically-scrolling feeds or galleries where user-uploaded images may have unpredictable heights. Returns a downloadable image URL.

• IMGIX_MAX_W

  Tool to set the maximum output width on an Imgix URL. Use when you need to cap width (works only with fit=crop). Call after specifying fit=crop on the URL.

• IMGIX_PALETTE

  Tool to extract a color palette from an image in CSS or JSON form. Use when you need to analyze an image's dominant colors after any transformations.

• IMGIX_PURGE_ASSET

  Tool to purge an asset from the imgix cache. Use when you need to invalidate cached versions of an image and force imgix to fetch a fresh version from origin on the next request.

• IMGIX_RECT

  Tool to select a source-image rectangle region in Imgix before other resizing. Use when you need to crop a specific region (x,y,w,h) of the source image.

• IMGIX_ROT_TYPE

  Tool to control rotation behavior when `rot` is applied. Use after applying a `rot` parameter to choose between pivot (show entire image) or straighten (zoom and crop) behavior.

• IMGIX_TXT_ALIGN

  Tool to align a text overlay on an Imgix image. Use when you need to position text by specifying vertical (top/middle/bottom) and horizontal (left/center/right) alignment.

• IMGIX_TXT_SHAD

  Set text shadow strength for imgix text overlays. The txt-shad parameter controls the drop shadow intensity (0-10) applied to text rendered on images. Note: This parameter only has a visible effect when combined with text overlay parameters (e.g., txt parameter). Use this action to add depth and visibility to text overlays on images.

• IMGIX_TXT_SIZE

  Tool to set text font size in pixels. Use when overlaying text and needing precise control over font size. Specify after defining the text content; default is 12px.

• Set CSS Palette Prefix

  Tool to set class-name prefix for CSS palette output. Use when customizing CSS selectors for color-palette styling.

• Set Device Pixel Ratio

  Tool to set device pixel ratio for an Imgix image. Use when rendering at specific display densities to ensure correct sharpness. Example: 'dpr=2&w=500&h=300' doubles resolution relative to dimensions.

• Set Output Quality

  Tool to set output quality for lossy formats. Use when adjusting image compression quality for lossy image delivery.

• Set Text Color

  Tool to set text overlay color on an Imgix image. Use when customizing text overlays with CSS color keywords or hex codes.

• Set Text Font

  Tool to choose font family/style for overlay text. Use when customizing text appearance after specifying content. Supports CSS font categories and optional bold/italic flags.

• Set Text Outline Width

  Tool to set outline width around overlay text. Use when styling text overlays on images.

• Set Watermark Base URL

  Tool to set the base URL prepended to the watermark image path. Use when you need to host watermark assets on a custom domain or CDN.

• Text Outline Color

  Apply an outline color to text overlays on Imgix images. The text outline must first be enabled using the txt-line parameter (outline width > 0). This action fetches and returns the rendered image with the specified outline color applied.

• Text Overlay

  Tool to render a single-line UTF-8 text overlay on an image. Use when you need simple text captions.

• Watermark Fit Mode

  Tool to set how a watermark fits its target dimensions. Use when applying a watermark and you need control over fitting behavior (e.g., selecting 'scale'). For 'crop', ensure 'mark-w' and 'mark-h' are also provided.

• Watermark Width

  Tool to set watermark width. Use when you need to enforce a watermark's width in pixels or as a proportion. Use after specifying watermark source.