#Named Transforms

Named transforms are reusable presets that define a set of image transformation parameters. Instead of specifying w_800,h_600,fit_cover in every URL, you can create a named transform called hero and use it as t_hero.

Named transforms list

#Creating a Transform

Click New Transform to open the creation form.

Create transform form

Enter:

  • Name — a URL-friendly identifier (e.g., thumbnail, hero-banner). This becomes the t_ value in URLs.

  • Parameters — set the transform parameters like width, height, fit mode, quality, blur, and format.

  • Locked parameters — mark specific parameters as locked to prevent URL overrides. For example, locking width to 200 means the URL t_thumbnail,w_999 will still use w_200.

#Using Named Transforms

Once created, use the transform name in image URLs:

https://img.pixault.io/{project}/{imageId}/t_thumbnail.webp

You can combine a named transform with additional (non-locked) parameters:

https://img.pixault.io/{project}/{imageId}/t_thumbnail,q_90.webp

#Editing and Deleting

Click any transform in the list to view its parameters. Use the Edit button to modify it or Delete to remove it.

Deleting a named transform does not affect cached images that were already generated with it. However, new requests using the deleted transform name will return an error.