Knowledgebase: Creating Content
Mass Content Uploader Part 1
Posted by Lee Conlin on 01 December 2009 04:18 PM

The mass content uploader is an easy way to upload content to your store.

Note: To use the content uploader you need to have MS Excel, OpenOffice Calc or some other spreadsheet application.

If you are starting from a new store then the first thing you will want to do is create a blank spreadsheet and enter the column headings. Column headings must go in row 1 and start from column A.

The minimum headings required to create a fully working product are as follows.

You need to ensure that the sheet is named "Products" .

HeadingData TypeDescription
ProductCode text This is the product code/EAN/SKU/ISBN or whatever you prefer to call it for the product. Please note that if you plan to use product codes that contain both letters and numbers then the first 5 product codes in your spreadsheet MUST contain both letters and numbers. This is a limitation of the Microsoft driver for reading Excel files programatically and cannot be avoided.

ShortDescription

 

text

 

This is the product name or title.

 

Teaser

text

This is the product teaser. This field can contain HTML and will be rendered out in your product teaser areas (and sometimes product details page) on your store.

Details

 

 

 

 

text

 

 

 

 

This is the products full description. This field can also contain HTML if required. Alternatively you can omit this column entirely and instead create a ".rtf" file for each product.  RTF is Rich Text Format and these files will allow you to format your product descriptions more easily.

When using RTF files you must include only one product description per file and the file must be named in the format <ProductCode>.rtf and placed in the same folder as the spreadsheet for now.  Once you have all of these files you must create a "ZIP" file and place all of the RTF files and the Spreadsheet file into the ZIP.
Price number This is the price of the product in pounds and pence.
i.e. 4.5 = £4.50

While the above fields are enough to create a fully working product you will likely want to also fill in the following fields to make the store easier to navigate and look more professional.

HeadingData TypeDescription

Category

 

formatted text

 

This is the primary category for the product. If this would be a sub-category then you must give the full path, separating parent and child categories with a ">" character.
i.e. : Toys>Cuddly Toys>Bears

StockLevel

 

number

 

The number of this product that is in stock. Use -1 if the product is to be classed as always in stock.

 

TeaserImageURL

 

 

 

 

 

 

url

 

 

 

 

 

 

If a web address to an image is entered in this field the system will download the image to the server and attach it to the product automatically. Note that the address given must be accessible on the internet. To check that the address is accessibly type it into your browser and see if the image is displayed. The address should link directly to the image file, not to a page with the image on.

Alternatively you could simply enter the filename of your image in this field and ensure that the image file its self is in the same folder as the spreadsheet.

Another option is to omit this column entirely and instead name the image files using the product codes (e.g. <ProductCode>.jpg)

Once you have all of these files you must create a "ZIP" file and place all of the image files (and any RTF files) and the Spreadsheet file into the ZIP. To create a zip file you need to right click on the file/folder that you want to zip and then go to send to and then there should be compressed to Zip folder click on that, and a new zipped folder will be made.

You now have enough to get started uploading products but as you go on there may be more you wish to do with your products. I have included a full list of all fields below along with a description of each.

HeadingData TypeDescription

ProductCode

 

text

 

This is the product code/EAN/SKU/ISBN or whatever you prefer to call it for the product. Please note that if you plan to use product codes that contain both letters and numbers then the first 5 product codes in your spreadsheet MUST contain both letters and numbers. This is a limitation of the Microsoft driver for reading Excel files programatically and cannot be avoided.

 

ShortDescription

 

text

 

This is the product name or title.

 

Teaser

 

text

 

This is the product teaser. This field can contain HTML and will be rendered out in your product teaser areas (and sometimes product details page) on your store.

 

Details

 

text

 

This is the products full description. This field can also contain HTML if required.

 

Price

 

number

 

This is the price of the product in pounds and pence.
i.e. 4.5 = £4.50

 

Category

 

formatted text

 

This is the primary category for the product. If this would be a sub-category then you must give the full path, separating parent and child categories with a ">" character.
i.e. : Toys>Cuddly Toys>Bears

 

StockLevel

 

number

 

The number of this product that is in stock. Use -1 if the product is to be classed as always in stock.

 

TeaserImageURL

 

 

 

url

 

 

 

If a web address to an image is entered in this field the system will download the image to the server and attach it to the product automatically. Note that the address given must be accessible on the internet. To check that the address is accessibly type it into your browser and see if the image is displayed. The address should link directly to the image file, not to a page with the image on.

 

DeliveryCharge

 

 

 

number

 

 

 

This is the field that is used to determine the delivery cost to the customer. Depending on which shipping method you use this field could represent:

  • Product weight in Kilograms
  • Additional charge to add to shipping for this product
  • Whether to add shipping for this product or not

IncludesSalesTax

 

yes/no

 

This field determines if the price entered in the "Price" column already includes sales tax or not. Only available when your sales tax mode is set to "Simple".

 

SalesTaxID

 

number

 

Identifies the sales tax class to apply to this product. Only applies when your sales tax mode is set to "Advanced". you can find the sales tax ID's in the table on the Sales tax Manager page.
i.e. Orders -> Sales tax details

 

Specifications

 

formatted text

 

This section is used to display technical specifications about a product and must have the text formatted in a particular way in order to render out correctly.

 

RelatedProducts formatted text This is a pipe delimited list of product codes. Related products are displayed on the product details page. Separate each code with a pipe character ( pipe = | )

ProductOptions

 

formatted text

 

This is a formatted string of text to create product options. It uses the same format as the product editor in the admin area. Cannot be used in conjunction with Advanced Options.

 

AdvancedOptions

 

 

 

 

 

 

 

 

 

 

formatted text

 

 

 

 

 

 

 

 

 

 

This is a formatted string that uses ';' and '|' characters to delimit its data to create a single product option for this product where each potential selection can have it's own stock level and code associated with it.

The format is as follows for each potential selection in the dropdown box:

OptionCode;OptionPriceAdjustment;
OptionDescription;OptionStockLevel;OptionShippingAmmount

Use a | character to separate selections as follows:

OptionCode;
OptionPriceAdjustment;
OptionDescription;
OptionStockLevel;
OptionShippingAmmount|Option2Code;
Option2PriceAdjustment;
Option2Description;
Option2StockLevel;
Option2ShippingAmmount

 

for example the first number is the option code, the second number is price adjustment, the third is the Description, the fourth is the stock level, and the last is the shipping amount for the product option

1;25;Big Lens Pack;5;10

StockMessage

 

text

 

Text to show if product is out of stock and stock messages are enabled in display settings.

 

DisplayOption

 

 

text from selection

 

 

 Always_On_Home_Page
Let_System_Decide
Never_On_Home_Page
Not_Shown_But_Searchable
Not_Shown_Non_Searchable
Hidden

FriendlyURL

 

 

 

text

 

 

 

Sets the last part of the web address for this product. for example a system generated address might look like "http://www.easywebstore.co.uk/Large-Acrylic-Jewels_APWQD.aspx"

If I enter "Large-Acrylic-Jewels" into this field the address would now be http://www.easywebstore.co.uk/Large-Acrylic-Jewels

 

DateAdded

 

 

date

 

 

This will autmatically be set to the current date when you upload if it is removed. Fill it in only if you want to specify the date added field.

Format: DD/MM/YYYY

 

AdditionalCategoryX

 

formatted text

 

A string formatted in exactly the same way as Category. X must be a number between 1 and 10.

 

AdditionalImageURL

 

url

 

 

This allows you to specify additional image addresses to be imported to the product. The first additional image would go in this field "AdditionalImageURL". The second would go in "AdditionalImageURL1", then "AdditionalImageURL2" and so on up to "AdditionalImageURL5".

 

KelkooCategory text

 

A valid Kelkoo category - used only when you have Kelkoo integration enabled.

 

DealtimeCategory text

 

A valid Dealtime category - used only when you have Dealtime integration enabled.

 

I have attached an example spreadsheet below.  Hover the mouse over the column names for reminders of what they do.

When you have your spreadsheet or zip file ready to import continue to Part 2



Attachments 
 
 excelexample .xlsx (11.48 KB)
(161 votes)
This article was helpful
This article was not helpful

Help Desk Software by Kayako Fusion