> ## Documentation Index
> Fetch the complete documentation index at: https://docs.convertly.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Download

> Force browser downloads with Content-Disposition attachment headers on CDN URLs.

Set `dl` on any CDN transform URL to send `Content-Disposition: attachment` instead of displaying the image inline.

```html theme={"system"}
<a href="https://cdn.convertly.sh/{key}/{id}?w=1200&format=jpeg&dl=hero.jpg">
  Download JPEG
</a>
```

## Parameters

| Param             | Value                                                                                                                                                    | Default        |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| `dl` (`download`) | Force download. `dl=filename.jpg` sets the filename. `dl=1`, `dl=true`, or bare `dl` uses a derived name from the source file + output format extension. | inline display |

## Examples

Custom filename:

```
?w=1200&format=jpeg&dl=product-hero.jpg
```

Derived filename (from stored file name + output format):

```
?w=800&format=webp&dl=1
```

Combine with any transform — resize, `format=auto`, `bgRemove`, presets, and signed URLs all work the same way. The attachment header is applied to the final encoded bytes after the pipeline runs.

See [Format & delivery](/docs/image-cdn/transforms/format-delivery) for negotiation and encoding options.