Quick Guide to Using the Importer
In this guide, you’ll learn the easiest way to use the importer to add the following to your business:
Categories
Products
Product modifiers (extras, options, and sub-options)
Part 1: Prepare Your Importer
If you already have a Multi Importer, you can skip to Step 2.
If not, you first need to add an importer that allows you to upload the data mentioned above by following these steps:
In your Dashboard, go to the Stores section.
Click on the Importers button https://d.pr/i/Sk8hLn
Select Add a New Importer https://d.pr/i/3OULe8
Add an importer of the "Multiple" type https://d.pr/i/I0rK9J.
First, add the Type Mapping for "Category", as shown in the image.
Repeat the process by adding the mappings for:
Products https://d.pr/i/sAhTQi
Extra Products https://d.pr/i/UH6Qgn
Extras https://d.pr/i/nBEm3K
Extra Options https://d.pr/i/8XIajK
Extra Option Sub-options https://d.pr/i/Vhp1Jg
Enter the name and slug for the importer and click Save.
Below is an example video showing the complete process of adding this importer.
https://d.pr/v/dzQgAs <-- Video
If you need assistance adding your importer, you can contact our support team at [email protected].
💡 Tip: Quickly create your importer using Postman.
With Postman, you can send this request to create your importer:
Request type: POST
Payload json file:
Image example: https://d.pr/i/su6is7
Part 2: How to Use Your Importer
With this importer, you can create and edit your categories, products, and product modifiers (Extras, Options, and Suboptions).
The importer processes the import row by row, associating the external IDs of your business and all other elements in the file.
Prepare your importer file:
In this link https://d.pr/f/Hb7bbT, we provide an example importer file that includes all fields. Later, additional examples will be provided for different use cases.
Prepare your business for import:
In your business settings, you need to edit the “External ID” value to match the one in your importer, don't forget to click Save.. This means that the content from your file will be imported into that business.
NOTE: Use a different ID for each business. Please see the attached image for reference. Keep the decimal point format in the file using a dot for prices, for example, 5.5.
3. Then, simply upload your importer file, and that’s it—your categories and products should now be visible.
Other Use Cases:
Importing only categories and products: You can import just the products, for example from this list . To do this, simply leave the unnecessary modifier fields (Extras, Options, and Suboptions) empty.
https://d.pr/f/sH0jwB <-- Example file
Making changes to products: If you only want to make updates, for example to product descriptions, you can perform the import while keeping the external IDs of your products. The importer will automatically update only the changes you made.
Importing multiple modifiers (Extras, Options, and Suboptions): You can use this importer file as an example, which imports different modifiers for a single product.
https://d.pr/f/pVpg6i <-- Example file