---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - en/function-ref/IMAGE
  - ru/function-ref/IMAGE
  - href: ru/function-ref/IMAGE.md
    type: text/markdown
    title: Markdown version
csp:
  - script-src:
      - https://mc.yandex.ru
    img-src:
      - https://mc.yandex.ru
    connect-src:
      - https://mc.yandex.ru
      - wss://mc.yandex.ru
    child-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-ancestors:
      - 'blob:'
      - https://mc.yandex.ru
canonical: ru/function-ref/IMAGE.html
editable: false
vcsPath: ru/function-ref/IMAGE.md
---

# IMAGE



#### Синтаксис {#syntax}


```
IMAGE( src [ , width [ , height [ , alt ] ] ] )
```

#### Описание {#description}
Позволяет вставить в таблицу изображение, расположенное по адресу `src`. Ширина (`width`) и высота (`height`) изображения указываются в пикселях. Если для одного из размеров указано значение `NULL`, он рассчитывается автоматически пропорционально размеру другой стороны. Если для обоих размеров указано значение `NULL`, изображение вставляется с исходными размерами. В случае проблем с загрузкой изображения функция выводит альтернативный текст `alt`.




**Типы аргументов:**
- `src` — `Строка`
- `width` — `Целое число`
- `height` — `Целое число`
- `alt` — `Строка`


**Возвращаемый тип**: `Разметка`

#### Примеры {#examples}



```
IMAGE('https://********/nature-01.jpg', 250, 150, 'alt-text-1')
```

```
IMAGE('https://********/nature-02.jpg', NULL, NULL, 'alt-text-2')
```



#### Поддержка источников данных {#data-source-support}

`ClickHouse 21.8`, `Файлы`, `Google Sheets`, `Microsoft SQL Server 2017 (14.0)`, `MySQL 5.7`, `Oracle Database 12c (12.1)`, `PostgreSQL 9.3`, `Trino`, `Яндекс Документы`, `YDB`.