---
title: Image Optimizer Default Settings
summary: >-
  Configures default settings for Fastly Image Optimizer requests, configuring
  the way images are optimized when not overridden by URL parameters on specific
  requests.
url: >-
  https://www.fastly.com/documentation/reference/api/services/image-optimizer-default-settings
---

Configures default settings for Fastly Image Optimizer requests, configuring the way images are optimized when not overridden by URL parameters on specific requests.

[Fastly Image Optimizer](https://docs.fastly.com/products/image-optimizer) (Fastly IO) is an [image optimization](https://www.fastly.com/learning/what-is-image-optimization) service that manipulates and transforms your images in real time and caches optimized versions of them.

Fastly Image Optimizer supports a variety of image formats and applies specific settings to all images by default. These can be controlled with this API or the [web interface](https://www.fastly.com/documentation/guides/full-site-delivery/image-optimization/about-fastly-image-optimizer/#configuring-default-image-settings). Changes to other image settings, including most image transformations, require using query string parameters on individual requests.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `allow_video` | boolean | Enables GIF to MP4 transformations on this service. |
| `jpeg_quality` | integer | The default quality to use with JPEG output. This can be overridden with the "quality" parameter on specific image optimizer requests. |
| `jpeg_type` | string | The default type of JPEG output to use. This can be overridden with "format=bjpeg" and "format=pjpeg" on specific image optimizer requests. |
| `resize_filter` | string | The type of filter to use while resizing an image. |
| `upscale` | boolean | Whether or not we should allow output images to render at sizes larger than input. |
| `webp` | boolean | Controls whether or not to default to WebP output when the client supports it. This is equivalent to adding "auto=webp" to all image optimizer requests. |
| `webp_quality` | integer | The default quality to use with WebP output. This can be overridden with the second option in the "quality" URL parameter on specific image optimizer requests. |

## API endpoints

### Get current Image Optimizer Default Settings

**GET** `/service/{service_id}/version/{version_id}/image_optimizer_default_settings`

Retrieve the current Image Optimizer default settings. All properties in the response will be populated.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |

### Update Image Optimizer Default Settings

**PATCH** `/service/{service_id}/version/{version_id}/image_optimizer_default_settings`

Update one or more default settings. A minimum of one property is required. The endpoint will respond with the new Image Optimizer default settings,
with all properties populated.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |