# add_image_size()

URL: https://chugunov.pro/api-wordpress/functions/add_image_size/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.9.0.

## Сигнатура

```php
add_image_size( string $name, int $width, int $height, bool|array $crop = false )
```

## Описание

Регистрирует новый размер изображения.

## Параметры

- `$name` `string` — обязательный. Идентификатор размера изображения.
- `$width` `int` — необязательный. Ширина изображения в пикселях. Значение по умолчанию 0.
- `$height` `int` — необязательный. Высота изображения в пикселях. Значение по умолчанию 0.
- `$crop` `bool|array` — необязательный, по умолчанию `false`. Поведение при обрезке изображения. Если false, изображение будет масштабировано (по умолчанию).
  
  Если true, изображение будет обрезано до указанных размеров с центрированием.
  
  Если передан массив, изображение обрезается с использованием массива для указания места обрезки: 0 stringПозиция обрезки по оси x. Принимает 'left', 'center' или 'right'.
  
  1 stringПозиция обрезки по оси y. Принимает 'top', 'center' или 'bottom'.

## Исходный код

Файл: `wp-includes/media.php:300`

```php
function add_image_size( $name, $width = 0, $height = 0, $crop = false ) {
	global $_wp_additional_image_sizes;

	$_wp_additional_image_sizes[ $name ] = array(
		'width'  => absint( $width ),
		'height' => absint( $height ),
		'crop'   => $crop,
	);
}
```

## История изменений

- 2.9.0 — Introduced.

## Связанные

Использует: [`absint`](https://chugunov.pro/api-wordpress/functions/absint/).
Используется в: [`_wp_add_additional_image_sizes`](https://chugunov.pro/api-wordpress/functions/_wp_add_additional_image_sizes/), [`set_post_thumbnail_size`](https://chugunov.pro/api-wordpress/functions/set_post_thumbnail_size/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/add_image_size/