Обзор
Импортирует группы полей, типы записей, таксономии и страницы опций из 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
Возврат
Команда выводит каждый импортированный элемент с его действием (Imported/Updated), типом, заголовком и ключом.
Примечания
- Файл должен иметь расширение
.json - Поддерживаются как JSON-файлы с одним элементом, так и массивы экспорта, содержащие несколько элементов
- Если элемент с тем же ключом существует, он будет обновлён, а не продублирован
- Страницы опций требуют ACF PRO
- Некорректный JSON или элементы без ключей пропускаются с предупреждением
Ошибки
| Ошибка | Причина |
|---|---|
| Файл не найден | Указанный путь к файлу не существует |
| Файл должен иметь расширение .json | Файл не является JSON-файлом |
| Файл импорта пуст или содержит некорректный JSON | JSON не удалось разобрать |
Обновлено: 02.06.2026