> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.weblium.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Імпорт товарів до Вашого Магазину

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

# Імпорт товарів

Щоб імпортувати товари до вашого магазину, вам потрібно перейти до списку товарів в налаштуваннях сайту та натиснути на кнопку Імпорт:

![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ukr2_1p2qj8v.png)

Далі система запропонує вам обрати один із доступних варіантів:

### Магазин Weblium

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

### Інші платформи

Оберіть цей варіант, якщо у вас вже є експортований файл з товарами з наступних платформ: [Shopify](https://help.shopify.com/en/manual/products/import-export/export-products), [Tilda](https://help-ru.tilda.cc/online-store-payments/import-export), [Ecwid](https://support.ecwid.com/hc/en-us/articles/207101289-Exporting-store-data#exporting-products) чи [Prom.ua](https://support.prom.ua/hc/uk/articles/360004961057), Хорошоп, Shop Express.

||| ${color}[#f97700](Важливо:) якщо деякі властивості продукту іншої платформи не підтримуються на Weblium (відповідно, поля для них відсутні у файлі експорту/імпорту), вони не будуть враховані та відображені у списку товарів після імпорту.

# Робота з шаблоном для імпорту Weblium

Після натискання на кнопку Завантажити шаблон, ви отримаєте файл в форматі `.csv`. Ми рекомендуємо працювати з ним через **Google Таблиці**, оскільки Excel не завжди коректно відкриває даний тип файлу. 

Імпортувати завантажений файл в Google Таблиці ви можете наступним чином:

![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ukr1_1tgzcuo.png)

На скриншоті нижче ви можете бачити варіант заповнення таблиці на прикладі шаблонного товару:

![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/shablon-3_1o9cq1m.png)
Розглянемо поля по порядку:

 **ID*** — **обовʼязкове для заповнення поле**; на основі цього поля буде формуватися посилання на ваш товар — наприклад, якщо домен вашого сайту це `example.com`, а значення ID дорівнює `product-one`, тоді URL (посилання) цього товару буде `https://example.com/shop/product-one`. Поле підтримує латинські символи, цифри та дефіс (-). Поле має бути унікальним та не повторюватися в інших товарах. Якщо товар має варіанти, це поле має бути однаковим для усіх варіантів товару.

|| ${color}[#ffa800](Примітка:) якщо під час імпорту в магазині відсутній товар з цим ID, то буде створено новий товар. Якщо товар з таким ID вже наявний, цей товар буде перезаписано (оновлено).

**Variant** — використовується для позначення варіантів  одного товару. Поле підтримує лише цифри. Під час імпорту нових товарів це поле потрібно залишити порожнім. Якщо ви імпортуєте раніше експортовані товари, у яких вже вказане значення у колонці “Variant”, не змінюйте це значення.

**Product Type*** — **обовʼязкове для заповнення поле**. Може мати значення "digital" (для цифрових товарів) та "physical" (для фізичних товарів).

**Name*** — **обовʼязкове для заповнення поле**; назва вашого товару. Можлива кількість символів — від 3 до 250.

**Description** — опис вашого товару, який відвідувачі зможуть побачити на сторінці товару. Максимально можлива кількість символів — 5 000. 

**Visibility** — вказує видимість товару на вашому сайті — чи буде відображатися товар на опублікованій версії сайту. Може мати значення “yes” (товар опубліковано) чи “no” (чернетка).

**Availability*** — **обовʼязкове для заповнення поле**; встановлює значення наявності вашого товару. Поле може містити такі значення: "in_stock", "available_for_order", "out_of_stock", "coming_soon" — в наявності, передзамовлення, немає в наявності та очікується відповідно.

**Track Inventory** — в цьому полі ви можете вказати, чи бажаєте відслідковувати кількість товару в наявності. Може мати значення “yes” (так) чи “no” (ні) відповідно.

**Inventory saldo** — якщо ви в попередній колонці вказали “yes”, то в цьому полі ви можете зазначити кількість товару в наявності. Значення не може бути негативним, у полі допускаються для використання лише цифри.

**SKU*** — **обовʼязкове для заповнення поле**, це артикул товару. Може містити як символи латиниці та кирилиці, так й цифри з символами. Мінімальна кількість символів у полі — 3, максимальна — 100.

**Old Price*** — **обовʼязкове для заповнення поле**, основна ціна товару. Якщо у вартість товару входять копійки, то між цілою та дробовою частиною має бути крапка. Приклад значення: `199.99`

**Sale price** — у цьому полі ви можете вказати вартість товару зі знижкою. Має бути меншою, ніж значення значення у колонці “Old Price” цього рядку таблиці. У імпортованого товару буде встановлена фіксована знижка у розмірі різниці між значеннями “Old Price” (стара ціна) та “Sale price” (нова ціна). Якщо у вартість товару входять копійки, то між цілою та дробовою частиною має бути крапка. Приклад значення: `150.20`

**Categories** — у цьому полі ви можете вказати, до яких категорій відноситься товар. Зазначимо декілька моментів:

ㅤㅤ• Якщо потрібно додати товар одразу до двох або більше категорій, то їх треба написати в одній клітинці, але в окремих рядках. У більшості табличних редакторів ви можете зробити окремий рядок всередині клітинки за допомогою комбінацій клавіш Alt+Enter (Windows) або Control+Option+Enter (macOS);
ㅤㅤ• На першому місці у переліку категорій має бути розміщена головна категорія товару;
ㅤㅤ• Якщо треба додати товар до підкатегорії, то треба її вказати у форматі `Назва материнської категорії/Назва підкатегорії` ; 
ㅤㅤ• Якщо вказаної вами категорії або підкатегорії не було створено попередньо в налаштуваннях сайту, її буде створено при імпорті автоматично.

Приклад заповненої клітинки у стовпчику “Categories” для товару, який буде додано до 3 категорій (“Головна категорія товару”, “Неголовна категорія товару” та “Підкатегорія категорії №1”):

```
Головна категорія товару
Неголовна категорія товару
Категорія №1/Підкатегорія категорії №1
```

**Keywords** — ключові слова сторінки товару для її SEO-оптимізації у пошукових системах. Їх також можна буде використовувати, щоб знайти товар у вашому магазині за допомогою пошуку товарів. Використовуйте кому як роздільник, якщо ви вводите більше одного ключового слова. Максимальна кількість символів — 255.

**SEO title** — вказує заголовок (тег  `<title>`) для сторінки товару, який буде відображатися у пошукових системах та у вкладці браузеру. Якщо не вказати це значення, то у якості тегу `<title>` сторінки товару буде використана назва товару. Максимальна кількість символів — 70.

**SEO description** — короткий опис сторінки вашого товару, що відображатиметься пошуковими системами у результатах пошуку.  Максимальна кількість символів — 320.

**SEO NOT Searchable** — вказує, чи заборонено пошуковим системам індексувати сторінку цього товару (чи буде цей товар приховано у результатах пошуку, наприклад, у Google). Може мати значення `yes` (товар закритий від індексації) чи `no` (товар доступний до індексації) відповідно.

|| ${color}[#ffa800](Примітка:) до грудня 2023 цей параметр називався “SEO Searchable” — якщо ви імпортуєте товари використовуючи старий файл імпорту (де вказано “SEO Searchable” замість “SEO NOT Searchable”), це поле не буде враховано системою і усі товари за замовчуванням будуть відкриті до індексації.

**Attributes** — додають товару атрибути, такі як вік, стать, бренд тощо. Заповнюється у форматі `Назва атрибуту: значення` ( з пробілом після двокрапки). Якщо треба додати декілька атрибутів до товару, то їх треба написати в одній клітинці, але в окремих рядках.

Якщо ви бажаєте додати не кастомний атрибут, а один з трьох передбачених нашою системою (“Бренд”, “Вікова група”, “Стать”), то перед назвою атрибуту на початку рядка треба додати у квадратних лапках ідентифікатор передбаченого нашою системою атрибуту (“Бренд” — `[brand]`, “Вікова група” — `[age_group]`, “Стать” — `[gender]`). Приклад заповненої клітинки у стовпчику “Attributes” для додавання 4 атрибутів:

```
Ваш кастомний атрибут: Значення кастомного атрибуту
[gender]Стать: Будь-яка
[age_group]Вікова група: 16+
[brand]Бренд: Weblium
```

|| ${color}[#ffa800](Примітка:) кожний з передбачених нашою системою атрибутів має бути унікальним, тобто не можна для одного товару додати 2 атрибути з `[brand]` напочатку (так само з `[age_group]` та `[gender]`).

**Images** — дозволяє додавати до товару зображення, які раніше вже були додані до інших товарів у налаштуваннях сайту на Weblium. Тобто кожне окреме зображення вперше можна додати лише у налаштуваннях сайту під час редагування товару. Проте якщо після цього цей товар з доданим зображенням експортувати, посилання на його зображення можна додавати й до інших товарів. Кожне зображення додається у окремому рядку в форматі `[noname|gallery](http://e-c.storage.googleapis.com/res/5f7ad59cd90e8539eb50ef24/original)`, де у напівкруглих дужках вказано посилання на зображення у нашій базі даних. Головне зображення товару має містити на початку рядку символ `*`. Також можна додати до товару відео у форматі `[noname|video|gallery](https://www.youtube.com/embed/Ss_qWAI7KOk)`, де `Ss_qWAI7KOk` — це ID вашого відео з YouTube (те, що йде у посиланні після `https://www.youtube.com/watch?v=` та перед першим символом `&`). 

|| ${color}[#ffa800](Примітка:) нині додавати відео до товарів можна лише за допомогою посилання на відео з YouTube.

| ${color}[#1aa900](Підказка:) на відміну від зображень, відео з YouTube можна додати до товару під час імпорту напряму, без попереднього завантаження на стороні Weblium в налаштуваннях певного товару.

||| ${color}[#f97700](Важливо:) відео не може бути головним зображенням товару (перед рядком, що додає відео, **не** має стояти символ `*`).

Приклад заповненої клітинки зображень (ці зображення були скопіювані з експортованого товару, тобто раніше їх вже завантажували до товарів у налаштуваннях Weblium сайту). У першому рядку головне зображення товару, у другому рядку — звичайне зображення, у третьому — відео з YouTube:

```
*[noname|gallery](http://e-c.storage.googleapis.com/res/5f731d7be7179b3e8352ce65/original)
[noname|gallery](http://e-c.storage.googleapis.com/res/9bd0a70a-c006-4675-a1d0-eaf9e310f688/original)
[noname|video|gallery](https://www.youtube.com/embed/Ss_qWAI7KOk)
```

**URL** — це поле не заповнюється та в подальшому не редагується. У ньому під час експорту товарів буде зазначене посилання на сторінку товару, щоб вам її було зручніше відкривати під час редагування файлу, якщо буде така потреба.

# Додавання варіативних товарів

Додавання параметрів товару, таких як колір, розмір тощо, відбувається за допомогою додавання колонки Option. На кожен параметр потрібна окрема колонка та на кожен варіант товару — новий рядок. Таким чином, якщо у нас є два параметри: колір та розмір, та у кожного з цих параметрів буде два значення, останні дві колонки таблиці будуть виглядати приблизно так:
![](https://storage.crisp.chat/users/helpdesk/website/fa84b4d83a50e800/ukr-8_687f0c.jpg)
Значення параметру вноситься у форматі `Назва параметру: значення` (наприклад, `Колір: червоний`).

При додаванні варіантів товару важливо, щоб у кожного варіанту товару були заповнені однакові поля (хоч інформація в них може відрізнятись, наприклад ціна чи SKU). При цьому у всіх варіантів товару **має співпадати ID**.

| ${color}[#1aa900](Підказка:) ви можете створити тестовий товар в вашому магазині,  експортувати його та використати як шаблон для імпорту інших товарів, що може бути зручніше, ніж працювати з пустим шаблоном.