--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/direct/doc/en/objects/adimage.md - https://yandex.com/dev/direct/doc/ru/objects/adimage.md - href: en/objects/adimage.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt sourcePath: en/dg/objects/adimage.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt # Image (AdImage) The Image (AdImage) object contains an image. The [AdImageHash](*AdImageHash) parameter is used as the image identifier. An ad can only have one image (or none at all). You can assign the same image to multiple ads. For more information, see [Images in ads](https://yandex.com/support/direct/en/efficiency/images.html) in Yandex Direct Help. ## Service {#service} Use the [AdImages](https://yandex.com/dev/direct/doc/adimages/adimages.html) service for uploading images as binary data, as well as for deleting images. To upload images asynchronously from a list of URLs, use the [Upload](https://yandex.com/dev/direct/doc/dg-v4/live/AdImage_Upload.html) action for the [AdImage \(Live\)](https://yandex.com/dev/direct/doc/dg-v4/live/AdImage.html) method in the Live 4 version of the API. Images can't be edited. If you need to change an image, you must upload a new image and assign it to the ad. To add an image to an ad or remove it from an ad, use the [Ads](https://yandex.com/dev/direct/doc/ads/ads.html) service (see [Ad extensions](https://yandex.com/dev/direct/doc/en/best-practice/launch-campaign.md#harness)). An image undergoes review only when it's added to an ad (see [Results of an ad extension review](https://yandex.com/dev/direct/doc/en/objects/ad.md#moderate-addon)). You can delete an image only if it is not assigned to any ads. To get a list of ads that a particular image is assigned to, use the [Ads](https://yandex.com/dev/direct/doc/ads/ads.html) service. ## Restrictions {#restrictions} The maximum number of images per user is 1000 + 2 × the number of ads. To check how many images a client can upload and how many have already been uploaded or are being uploaded, use the [GetLimits](https://yandex.com/dev/direct/doc/dg-v4/live/AdImage_GetLimits.html) action for the [AdImage \(Live\)](https://yandex.com/dev/direct/doc/dg-v4/live/AdImage.html) method in the Live 4 version of the API. ## Requirements for images uploaded via the API {#requirements} - Allowed image formats: JPG, PNG, GIF. - Acceptable image sizes for image ads: - 240 × 400, 300 × 250, 300 × 500, 300 × 600, 320 × 50, 320 × 100, 320 × 480, 336 × 280, 480 × 320, 480 × 800, 600 × 500, 600 × 1000, 600 × 1200, 640 × 100, 640 × 200, 640 × 960, 672 × 560, 720 × 1200, 728 × 90, 900 × 750, 900 × 1500, 900 × 1800, 960 × 150, 960 × 300, 960 × 640, 960 × 1440, 960 × 1600, 970 × 250, 1008 × 840, 1200 × 1000, 1200 × 2000, 1200 × 2400, 1280 × 200, 1280 × 400, 1280 × 1920, 1344 × 1120, 1440 × 960, 1456 × 180, 1920 × 1280, 1940 × 500, 2184 × 270, 2910 × 750, 2912 × 360, 3880 × 1000; - Maximum file size of 512 KB. - Acceptable image sizes for other types of ads: - When the aspect ratio is from 1:1 to 3:4/4:3 — from 450 to 5000 pixels on a side. - When the aspect ratio is 16:9, each side must be from 1080 × 607 to 5000 × 2812 pixels long. - Maximum file size of 10 MB. ## Type of image {#type} The type of image (the [Type](*Type) parameter returned by the `get` method) is determined automatically during upload. The types are described in the table: #| || **Type** | **Description** | **Suitable for ad types** || || REGULAR | Aspect ratio from 1:1 to 3:4/4:3 Size from 450 to 5000 pixels on each side | TEXT_AD DYNAMIC_TEXT_AD || || WIDE | Aspect ratio of 16:9 Size from 1080 × 607 to 5000 × 2812 pixels | TEXT_AD DYNAMIC_TEXT_AD MOBILE_APP_AD || || FIXED_IMAGE | One of the sizes: 240 × 400, 300 × 250, 300 × 500, 300 × 600, 320 × 50, 320 × 100, 320 × 480, 336 × 280, 480 × 320, 480 × 800, 600 × 500, 600 × 1000, 600 × 1200, 640 × 100, 640 × 200, 640 × 960, 672 × 560, 720 × 1200, 728 × 90, 900 × 750, 900 × 1500, 900  × 1800, 960 × 150, 960 × 300, 960 × 640, 960 × 1440, 960 × 1600, 970 × 250, 1008 × 840, 1200 × 1000, 1200 × 2000, 1200 × 2400, 1280 × 200, 1280 × 400, 1280 × 1920, 1344 × 1120, 1440 × 960, 1456 × 180, 1920 × 1280, 1940 × 500, 2184 × 270, 2910 × 750, 2912 × 360, 3880 × 1000 | IMAGE_AD || |# {% note info %} For backward compatibility, the following image types are used: - SMALL: Aspect ratio from 1:1 to 3:4; size of 150 pixels on the shorter side. - UNFIT: The image type is unknown or not supported by this API version. Images with this type can't be assigned to an ad. {% endnote %} [*AdImageHash]: Hash of the image. [*Type]: The type of image. See [Type of image](#type).