Обзор
Импортирует группы полей, типы записей, таксономии и страницы настроек из JSON-файла.
Описание
Читает экспортированный JSON-файл ACF и импортирует содержащиеся в нём элементы в базу данных, воспроизводя работу интерфейса импорта в админ-панели WordPress. Если элемент с таким же ключом уже существует, он будет обновлён.
Опции
wp acf json import <file>
<file>
(string) Обязательный параметр. Путь к импортируемому JSON-файлу.
Примеры
Импорт из экспортированного файла
$ wp acf json import ./acf-export-2025-01-01.json
Импортирована группа полей: Моя группа полей (group_abc123)
Импортирован тип записи: Книга (post_type_def456)
Успешно: импортировано элементов: 2.
Импорт JSON-файла с одной группой полей
$ wp acf json import ./group_abc123.json
Импортирована группа полей: Поля продукта (group_abc123)
Успешно: импортирован 1 элемент.
Повторный импорт для обновления существующих элементов
$ wp acf json import ./acf-export.json
Обновлена группа полей: Моя группа полей (group_abc123)
Успешно: импортирован 1 элемент.
Импорт файла из каталога acf-json
$ wp acf json import ./wp-content/themes/mytheme/acf-json/group_abc123.json
Результат
Команда выводит каждый импортированный элемент с указанием выполненного действия (импортирован или обновлён), типа, заголовка и ключа.
Примечания
- Файл должен иметь расширение
.json - Поддерживаются как JSON-файлы с одним элементом, так и экспортированные массивы, содержащие несколько элементов
- Если элемент с таким же ключом уже существует, он будет обновлён, а не продублирован
- Для страниц настроек требуется ACF PRO
- Некорректный JSON или элементы без ключей пропускаются с предупреждением
Ошибки
| Ошибка | Причина |
|---|---|
| Файл не найден | Указанный путь к файлу не существует |
| Файл должен иметь расширение .json | Файл не является JSON-файлом |
| Файл импорта пуст или содержит некорректный JSON | Не удалось разобрать JSON |
Обновлено: 30.09.2026