Skip to main content
A Preset is a named collection of transformation parameters that you can apply to any asset dynamically via the URL. Presets are highly useful for defining common formats (like “thumbnail”, “hero-banner”, “mobile-video”) without hardcoding massive query strings into your application code. When you create a preset via the API (or in your Dreep Dashboard), it gets a unique key (e.g. avatar_sm).

​
Applying a Preset

Once a preset is created, you can apply it to any public or signed media URL by appending the ?p=preset_key query parameter.

​
Supported Preset Settings

When creating a preset, you pass a settings JSON object. The parameters you can provide match the exact same parameters used in the dynamic URL transformation APIs: Image Preset Settings Example:
Video Preset Settings Example:

​
Overriding Presets

If you provide a preset ?p= but also explicitly provide a URL query parameter, the URL query parameter will take precedence over the preset setting. For example, if your avatar_sm preset sets format=webp, but you fetch ?p=avatar_sm&format=png, the resulting image will be a PNG.