Імпорт товарів у Shopify через CSV: що знати наперед і де все ламається

Новий магазин створити швидко, а от товари — ні. Якщо ви переходите з іншої системи або хочете змінити сотні цін одразу, рано чи пізно потрапите на імпорт через CSV. Це таблиця, де кожен рядок описує товар або варіант. Сам імпорт — кілька кліків. Вся робота в підготовці, а кілька пасток потім не скасувати. Цей текст проводить власників магазинів без технічного бекграунду через увесь процес.

Щодо обсягу: я спираюся на довідкові сторінки Shopify про імпорт та експорт товарів (станом на жовтень 2026). Пообіцяти з них, що саме ваш файл пройде одразу, я не можу. Це залежить від того, як він побудований.

Для чого потрібен імпорт CSV

За довідкою Shopify, імпорт корисний, коли ви переходите на Shopify з іншої платформи або хочете внести багато змін у товари чи залишки одразу. Під час імпорту дані з файлу перетворюються на товари. Ви обираєте, чи публікувати нові товари в усіх каналах продажу, чи лише в інтернет-магазині.

Для менших змін імпорт не потрібен: довідка називає масовий редактор в адмінці найпростішим способом правити кілька товарів або варіантів одночасно.

Найважливіше правило: спершу резервна копія

Дві примітки з довідки Shopify, які я б поставив на початок:

• Імпорт через CSV не можна скасувати, коли він почався, і історії попередніх імпортів немає. Що змінив імпорт, видно в журналі активності магазину.
• Shopify прямо радить зробити резервну копію даних про товари перед імпортом.

Резервна копія проста: спершу експортуйте товари як CSV (розділ «Товари», кнопка «Експорт»). Цей файл водночас є вашим шаблоном, бо показує, як Shopify називає стовпці. Під час експорту можна обрати CSV для Excel, Numbers чи іншої табличної програми або простий CSV для текстового редактора. Залежно від обсягу файл приходить поштою замість завантаження.

Що має бути у файлі

Коли ви створюєте нові товари, за довідкою обов’язковий лише стовпець Title. Щойно в товару є варіанти, потрібен ще стовпець URL handle, тобто ідентифікатор, що стоїть і в адресі товару. Під час оновлення наявних товарів обов’язкові лише URL handle і Title.

Але стовпці залежать один від одного. Якщо змінюєте стовпець варіанта, як-от SKU чи вага, потрібно додати й Option1 name та Option1 value. Якщо їх немає, за довідкою створюється новий варіант за замовчуванням, а наявні варіанти видаляються. Товар може мати до трьох опцій, наприклад розмір і колір.

Дві речі імпорт CSV не підтримує: метаполя варіантів (для них є масовий редактор варіантів) і масове видалення товарів. Доступність товарів в інших каналах продажу через CSV теж не можна масово оновити.

Створити нові чи перезаписати?

У імпорті є прапорець Overwrite products with matching handles (перезаписати товари з однаковим handle). Його дія:

• Без прапорця товари, handle яких уже існує, під час імпорту ігноруються.
• З прапорцем значення з файлу замінюють значення наявних товарів, для всіх стовпців, що є у файлі.

Звідси три правила, які Shopify наводить у довідці і які часто пропускають:

1. Якщо необов’язковий стовпець у файлі порожній, наявне значення в магазині теж стає порожнім. Якщо в магазині в полі «постачальник» (Vendor) є значення, а у файлі нічого, значення зникне.
2. Якщо стовпця у файлі немає взагалі, наявне значення в магазині лишається як було.
3. Якщо змінити значення опцій (від Option1 value до Option3 value), наявні ідентифікатори варіантів видаляються й створюються нові. Це може зламати те, що на них спирається, наприклад додатки сторонніх розробників.

Якщо хочете змінити лише ціни, беріть лише ті стовпці, які справді змінюєте, плюс потрібні обов’язкові стовпці та стовпці опцій.

Де найчастіше ламається

Довідка Shopify сама веде список типових проблем. Найважливіші з погляду власника магазину:

Сортування в Excel чи Numbers. Якщо CSV відсортувати в табличній програмі, товари можуть відокремитися від посилань на зображення, і під час імпорту зображення губляться. За довідкою, відсортований файл може перезаписати ваші наявні товари хибними даними, які не відновити. Тому не сортуйте таблицю перед імпортом.

Дивні символи в текстах. Якщо спеціальні символи виглядають хибно, файл збережено не в UTF-8. За довідкою, Google Sheets зберігає в UTF-8 автоматично, в інших програмах може знадобитися додатковий крок. Особливо варто перевірити німецькі умляути.

Заголовки стовпців не збігаються. Заголовки мають точно збігатися з шаблоном, включно з регістром («Title», а не «title»). Якщо вони відрізняються або їх бракує, за довідкою імпорт завершується помилкою. Тоді може з’явитися повідомлення на кшталт «Network error: Unexpected token».

«Кучеряві» лапки. Помилка «illegal quoting» виникає, за довідкою, коли у файлі є коми чи лапки не в кодуванні UTF-8. Типово це лапки-«ялинки» чи «кучеряві» замість прямих.

Розмір файлу. CSV з товарами не може перевищувати 15 МБ. Якщо виникає помилка або тайм-аут, розділіть файл на кілька менших і завантажте по черзі.

Переміщення опцій. Якщо перенести опцію з позиції 1 на позицію 2 (наприклад, розмір з Option 1 на Option 2, а нову опцію поставити першою), може з’явитися помилка на кшталт «Line is invalid». Довідка описує обхідний шлях із тимчасовою назвою опції та другим імпортом.

Довідка також радить для завантаження користуватися браузером Google Chrome.

Як проходить імпорт

1. В адмінці Shopify відкрийте Товари і оберіть Імпорт.
2. Додайте файл CSV.
3. Вирішіть, чи з’являться нові товари в усіх каналах продажу, чи лише в інтернет-магазині.
4. Вирішіть, чи перезаписувати наявні товари з тим самим handle.
5. Завантажити й продовжити, перевірте підсумок і підтвердьте імпорт.

Після завантаження на адресу пошти вашого акаунта приходить підтвердження від Shopify. Окремо про статус: якщо стовпця Status у файлі немає, за довідкою товари завантажуються як активні. Якщо хочете перевірити нові товари, перш ніж їх побачать клієнти, вкажіть статус свідомо.

Великий імпорт: спершу невеликий тест

Shopify радить партнерам, які роблять великий імпорт для мерчанта, спершу протестувати невелику вибірку в тестовому магазині. Принцип діє і без статусу партнера: імпортуйте спершу два-три товари, перегляньте в магазині варіанти, зображення, ціни та спецсимволи, і лише тоді запускайте весь файл.

Чекліст перед імпортом

1. Експорт усіх товарів збережено як резервну копію?
2. Файл збережено в UTF-8, заголовки не змінено?
3. Таблицю не сортовано?
4. Для варіантів: URL handle, Option1 name і Option1 value у кожному відповідному рядку?
5. У файлі лише стовпці, які справді мають змінитися?
6. Прапорець перезапису свідомо поставлено або свідомо не поставлено?
7. Стовпець Status заповнено, щоб ніщо не вийшло в прямий ефір випадково?
8. Спершу зроблено невеликий тестовий імпорт?

Під час переходу з іншої системи

Якщо товари з WooCommerce, Wix, Shopware чи іншого магазину, імпорт CSV — лише частина переходу. Файл має відповідати формату Shopify. Якщо заголовків бракує або вони відрізняються, імпорт завершується помилкою. До цього додаються перенаправлення зі старих адрес, дані клієнтів, замовлення й тексти. Як планувати адреси, описано в статті Перехід на Shopify і SEO: налаштувати перенаправлення та зберегти позиції. Чекліст повного переходу з WooCommerce — у статті Як переїхати з WooCommerce на Shopify без втрати позицій.

Коли допомагає розробник

Для кількох десятків товарів багато власників справляються самі: експорт, таблиця, імпорт. Допомога має сенс, коли файл прийшов із чужої системи й потребує перебудови, коли задіяно багато варіантів з кількома опціями, коли наявні товари треба перезаписати так, щоб не постраждали додатки та замовлення, або коли імпорт є частиною переходу з фіксованою датою запуску. Хто за що відповідає, пояснює стаття Допомога з Shopify: коли вистачає Help Center, а коли потрібен розробник.

Поширені запитання

Чи можна скасувати імпорт? За довідкою Shopify, запущений імпорт CSV не можна скасувати, і історії попередніх імпортів немає. Тому резервна копія наперед. Зміни видно в журналі активності магазину.

Чи вистачить Excel? Excel підходить, якщо файл збережено як CSV з комами між значеннями та в UTF-8. За довідкою, Google Sheets зберігає в UTF-8 автоматично, в інших програмах може знадобитися додатковий крок.

Чи можна видаляти товари через CSV? Ні. За довідкою, товари не можна масово видаляти через CSV. Для цього є масові дії в розділі «Товари» адмінки.

Скільки коштує імпорт товарів у розробника? Це залежить від обсягу та стану даних. Конкретних сум тут не називаю.

Як справи з вашим магазином?

Надішліть мені адресу вашого магазину для безкоштовної перевірки. Я дивлюся на те, що видно ззовні, наприклад час завантаження, додатки в коді сторінки та структуру сторінок, і скажу, що впадає в око. Я працюю лише з публічно доступними даними, без доступу до вашого акаунта. Якщо ви переходите з WooCommerce, я беру на себе перехід на Shopify. Що ще я роблю для магазинів, дивіться в розділі Послуги.

Читайте також: Метаполя й метаоб’єкти Shopify: структуровані дані товарів · Перехід з Wix на Shopify · Складські залишки в Shopify · Варіанти товару в Shopify

Kiril Karatitsyn, Shopify-розробник у Німеччині