​
Overview

Bundles are two or more items sold together. Creating a bundle allows you to group items that are exclusively sold together or group items that can be purchased together and separately. This document covers the process of importing bundles, which is done using a CSV or JSON file.

​
File Guidelines

You can import products using a CSV or JSON file only; no other data or file formats are supported.
  • SKU is a required field to create or update a bundle.
  • When adding a SKU to a bundle, enter the quantity to add in the same cell as the SKU itself. For example, if a bundle requires two of item 12345, enter 2, 12345 in the SKU cell.
  • When updating or upserting bundles, entering null in a spreadsheet cell will override existing values with blank values.
Although not required, we recommend that you download the template file to use as a guide when creating your own file for import to minimize errors during the import process.

​
Attribute Data Format

When preparing your file for import, ensure that the attribute data format aligns with following attribute type requirements:
  • String: Ensure the data is in text string format. If a string attribute contains multiple values, the values need to be sent as a stringified array, for example: ["a","b"].
  • Number: Numerical data only.
  • Boolean: Use true or false only; other values will be ignored.

​
Procedure

  1. In the left menu, click Catalog Connector > List > Bundles.
    The Bundles page is displayed.
  2. Click Import bundles.
    The Import CSV file window is displayed. This window provides a link to download example templates for JSON and CSV files.
  3. To import a file, do one of the following options:
    • Drag and drop the file into the window.
    • Click Select a File from your computer.
  4. Click Import file.
The file is imported and the bundles are added to your product list. fabric stores the files that you upload to your account. You can view the status of the import operation and re-download the original files by visiting the Import History page.

​
Troubleshooting

For a list of common errors when importing and how to correct them, refer to the following table:
Error MessageDescriptionImpactSolutionComment
Internal Server ErrorServer issuesThe bundle isn’t created or updated.Try againThis is an intermittent issue.