> For the complete documentation index, see [llms.txt](https://docs.cloudimage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudimage.io/setup/shortening-urls/presets.md).

# Presets

Cloudimage Presets are reusable templates of assets transformations that you can apply to any image or video for consistent results with a single click.

If you wish to apply the same transformations on many assets, you can define Presets (p) and apply transformations only using the Preset name (X).

<mark style="color:orange;">**p=X**</mark>

All [Image operations](/transformations/image-operations.md) and [Image filters](/transformations/image-filters.md) can be included in a Preset, as well as [Image watermarking](/transformations/image-watermarking.md) and [Image compression](/transformations/image-compression.md) parameters.

You can find all your Presets in the admin panel, *Settings / Image Settings* / *Presets*.

<figure><img src="/files/HpTi4zYGT9JRMR2Z436H" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/FINgCblZ1c7pS0jAsKSG" alt=""><figcaption></figcaption></figure>

### Defining new Presets&#x20;

#### ...using the Asset Variation Builder

Most of the on-the-fly image transformations can be configured using the [Asset Variation Builder](/transformations/asset-variation-builder.md), an in-line URL  builder to preview each image transformation instantly.

Imagine you’re preparing images for an e-commerce product page. With the Asset Variation Builder, you can:

1. **Open the image** from the *Preset Settings* page.
2. **Apply transformations**:
   * Crop to a square ratio (1:1) for consistency across product listings
   * Automatically center the crop on the model face
   * Define webp as the best forced format
3. **Preview in real time** how the image will look once delivered.
4. **Save as a Preset** called *“E-commerce Hero”*.

<figure><img src="/files/USAsUoyIhccBOpzSI7FV" alt=""><figcaption></figcaption></figure>

Now, every product photo uploaded to Cloudimage can instantly use this Preset, ensuring all visuals share the same style, quality, and format — without manual edits or developer input.

Presets can be previewed in the Cloudimage Asset Library in *Asset Details / Variations*

#### ...using the documentation <a href="#od_cf858787" id="od_cf858787"></a>

{% hint style="info" %}
Visit the **Transformations** section of our documentation to discover all the available transformations you can use in Presets.
{% endhint %}

| Preset name     | Operations and filters                                                                                                                                                                                                                                                                                                                                                                                                              | Syntax                                                                                                                                                                      | Preview                          |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| gallery\_thumb  | <mark style="color:orange;">**w=250**</mark>&<mark style="color:orange;">**h=250**</mark>&<mark style="color:green;">**gray=1**</mark>                                                                                                                                                                                                                                                                                              | [/samples.scaleflex.com/birds.jpg?<mark style="color:orange;">**p=gallery\_thumb**</mark>](https://doc.cloudimg.io/https://samples.scaleflex.com/birds.jpg?p=gallery_thumb) | ![](/files/j1gnpMkR61j0JLen8zut) |
| gallery\_medium | <mark style="color:orange;">**w=450**</mark>&<mark style="color:orange;">**h=300**</mark>&<mark style="color:orange;">**radius=10**</mark>&<mark style="color:green;">**force\_format=jpeg**</mark>&<mark style="color:green;">**q=85**</mark>                                                                                                                                                                                      | [/samples.scaleflex.com/birds.jpg?<mark style="color:orange;">**p=gallery\_thumb**</mark>](https://doc.cloudimg.io/https://samples.scaleflex.com/birds.jpg?p=gallery_thumb) | ![](/files/s9DhMac80HzEnfkoU6xy) |
| gallery\_large  | <mark style="color:orange;">**w=1200**</mark>&<mark style="color:green;">**force\_format=jpeg**</mark>&<mark style="color:green;">**optipress=2**</mark>&<mark style="color:purple;">**wat=1**</mark>&<mark style="color:purple;">**wat\_gravity=northwest**</mark>&<mark style="color:purple;">**wat\_scale=60**</mark>&<mark style="color:purple;">**wat\_pad=20**</mark>&<mark style="color:purple;">**wat\_opacity=0.4**</mark> | [/samples.scaleflex.com/birds.jpg?<mark style="color:orange;">**p=gallery\_large**</mark>](https://doc.cloudimg.io/https://samples.scaleflex.com/birds.jpg?p=gallery_large) | ![](/files/r4NzeQiRX3lxEdN0BA3X) |

You can use additional operations together with a preset. Here is an example:

| Preset name      | Operations and filters                                                                                                                                                                                                                                                                                                                                                                                                                 | Syntax                                                                                                                                                                                                                                                  | Preview                          |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| red\_ref\_number | <mark style="color:orange;">**w=400**</mark>&<mark style="color:orange;">**h=200**</mark>&<mark style="color:purple;">**wat=1**</mark>&<mark style="color:purple;">**wat\_gravity=northeast**</mark>&<mark style="color:purple;">**wat\_pad=10**</mark>&<mark style="color:purple;">**wat\_font=Arial-Black**</mark>&<mark style="color:purple;">**wat\_fontsize=18**</mark>&<mark style="color:purple;">**wat\_colour=660000**</mark> | [/samples.scaleflex.com/flat1.jpg?<mark style="color:orange;">**p=red\_ref\_number**</mark>&<mark style="color:orange;">**wat\_text=label1**</mark>](https://doc.cloudimg.io/https://samples.scaleflex.com/flat1.jpg?p=red_ref_number\&wat_text=label1) | ![](/files/iHODnYVddk9DZQ0X26NE) |

{% hint style="info" %}
Please note that an operation defined in any given preset cannot be overridden in the URL. For example, if a preset named **small\_img** contains **w=200**, using /**original\_image\_url**?**p=small\_img**&**w=400** will still yield a 200-pixel-wide image.
{% endhint %}

####


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudimage.io/setup/shortening-urls/presets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
