Import product catalog in Portal

You can import product information for multiple products using a single Excel spreadsheet. Use the spreadsheet to import data for new products as well as append missing data to existing products. You must require the  Product Catalog Administrator  role to do the import.

Note: The import file must be a valid Excel file and be no larger than 5 MBs. Import products don’t support the older .xls file format.

To import products

  1. From the navigation bar, select More > Product Catalog. The Products list appears.



  2. Select Import products. The Import products modal appears.



    Note: If you're importing products for the first time, we recommend that you select the Download example file link. Examining the example spreadsheet will help you to understand the format requirements.
  3. Drag and drop your Excel spreadsheet onto the Import products modal. Alternatively, browse to the required Excel spreadsheet.
    Note: The file can only be imported to the catalog once verified. Verification can take up to five minutes.
  4. Review file analysis: The system checks the uploaded file in real time. The File summary shows the results.
    1. If you see errors, select Download errors and warnings, fix the issues, and upload the file again.
    2. To cancel the upload, select X. You can still import the file even if it contains errors or warnings.
  5. Select your import options:

    1. Fields with multiple values: Some fields can store more than one value (for example, Global Trade Item Numbers (GTINs)). Choose how the system should handle existing values:
      1. Add new values to existing values: Keeps the current values and adds the new values from your file.
      2. Replace existing values: Removes the current values and uses only the new values from your file.
    2. Source priority: Choose which source takes priority when the same product is updated in both the feed and Portal.
      1. Portal: Values entered in Portal take priority. Future feed updates do not overwrite them.
      2. Feed: The feed controls the value. The next feed can update or overwrite it
  1.  Select Import and finish. If you’re having issues importing your file, refer to the section on troubleshooting.

Note: Importing data using the Product Catalog application will always take precedence and override data updates coming from your feed or from Dynamic Catalog Collection (DCC). Learn more about data source priority.

Feed source behavior

If you add product data in the Bazaarvoice Portal and select Feed as the source, 

  • Incremental Feeds (default): The product remains active, even if it is not included in your next feed file.
  • Full Feeds: Include that data in your next full feed file. If you do not include it, the system marks that product as inactive

Verification

Verification takes place at two levels:

  • File-level analysis—focuses on the overall file validity. Verification ensures that the file conforms to a specific format and contaiins specific mandatory information. Warning: Verification failure at file level means you can’t import your file. Learn how to troubleshoot a failed import.

  • Row-level analysis—focuses on row-by-row validity. Verification failure at row level means you won’t be able to import a specific product row (the invalid row may not contain information in the correct format).

    Note: However, you can still continue with a partial import of the file which includes valid product rows only.
Tip
You can also correct your Excel spreadsheet before importing. Download the errors and warnings log, and update your file accordingly.

Troubleshooting

File-level analysis Error message Recommendation
Invalid file Local validation failed. Ensure the import file is a valid Excel spreadsheet.
File too large Selected file is over 5MB. Separate into smaller Excel spreadsheets and upload them one at a time.
Empty file File does not contain any rows. Open the file and add product information using separate rows for each product.
Unrecognized column header Column header is not valid. Ensure that column header is using the correct format. The data in the invalid column won’t be imported.
Invalid product ID File does not contain an external ID or a product ID. The file must contain a valid Product ID column. Open the file and make sure there is a Product ID column.
Note: Product ID does not have to be the first column.
Invalid category ID File does not contain a category ID. If the file contains category information, it must also contain a corresponding Category ID column. Open the file and make sure there is a Category ID column.
Invalid brand ID File does not contain a brand ID. If the file contains brand information, it must also contain a corresponding Brand ID column. Open the file and make sure there is a Brand ID column.
File contains more than one Excel worksheet No error message appears. If the Excel spreadsheet contains more than one worksheet, only data from the first worksheet is imported.

Learn how to troubleshoot and update your catalog with the Optimize Your Bazaarvoice Product Catalog course at Bazaarvoice University.

Troubleshooting and updating your product catalog

Spreadsheet format

Each column in the import file contains information that can be added to your product catalog. Each row in your spreadsheet represents one of your products.

The following table provides important format information for your Excel spreadsheet:

Column name Description Required
ProductID Unique product ID that can contain only alphanumeric characters, hyphens (-), and underscores (_). The ID is not case sensitive.

Type: string

Yes
ProductName Name of the product, which is visible to end users.

Type: string

Strongly recommend
ProductPageURL Unique, uncorrupted URL for a product page. Do not include extraneous query string parameters that you might use for tracking and partnership codes. If the URL contains a reserved (special) character, you must URL-encode the character. For example, use & for an ampersand, use %20 for a space, or use %5B and %5D for square brackets ([ ]).

Type: URL

Strongly recommend
ProductImageURL Unique URL for the product image.

Type: URL

Strongly recommend
ProductDescription Description of the product. We recommend that product descriptions be at least three sentences or 300 characters long.

Type: string

Strongly recommend
Brand The name of the brand to which the product belongs.

Type: string

Strongly recommend
Brand ID Brand ID for the product.

Type: string

Yes. Required if Brand is included as a heading.
Category The product's category name. Each product needs to belong to a category or sub-category.

Type: string

Strongly recommend
CategoryID Category ID for the product.

Type: string

Yes. Required if Category is included as a heading.
Inactive Marks the product inactive if a yes or true value is specified in this column.

Type: boolean

No
ModelNumber Unique referencing code that businesses use to identify a part that a particular industry uses. Each model number can contain letters, numerals, and other characters.

Type: array

No. However, if included, one for each product.
ManufacturerPartNumber Manufacturer-specific part number (MPN). Part numbers can contain alphanumeric and special characters.

Type: array

Strongly recommend
EAN European Article Numbers (EAN), which is used worldwide for marking retail goods. An EAN must be a string of eight or 13 numerals. No letters or other characters are allowed. Remove spaces and hyphens for syndication.

Type: array

Strongly recommend
UPC Universal Product Code (UPC) is used for standard retail packaging in the United States. A UPC can contain numerals only, with no letters or other characters. Remove spaces and hyphens for syndication.

Type: array

Strongly recommend
ProductFamily Product family name shows which family the product belongs to. We recommend you exclude special characters from product family names.

Type: string

No
ProductFamily-Expand Product family expand (or product bundle) enables a product to receive and display reviews about all family members. A relevant product bundle name should be included if a product family name has been added.

Type: string

No
Provide feedback button