Welcome Guest!
Sign In
Automotive     Baby     Cellular     Crafts     Electronics     Home & Garden     Music

One of the most useful Seller tools at Atomic Mall is the AtomicUploader - a utility which allows our vendors to bulk list hundreds or even thousands of items at a time, saving valuable time and effort.

To use the AtomicUploader, each bit of data or "field" in your text file must be separated by an ASCII TAB character. This is how the uploader software knows how to distinguish between your selling price and your quantity (as an example). Any popular spreadsheet application like Microsoft Excel is able to produce TAB-delimited text files suitable for use with AtomicUploader.

In addition to your actual data, a header must be included in each uploaded file which tells our software which fields contain which types of data. Like the data itself, each field in the header is separated or "delimited" by a TAB character:

The above example only shows the first six field values contained within the header. A template file is available for download which contains a useable header as well as a sample product line. Click the link and select:

File > Save Page As.. to save it to your hard drive.

Be careful not to change the order of the header values or modify the header in any way when including it in your upload file! It must remain as-is in order to assure error-free AtomicUploader sessions. Of course you'll want to use your favorite text editor to delete the sample product line and informative text before using the file in an actual upload, or you can download the header by itself and use it as-is.

Below is a complete list of field header values shown in correct sequence, and the type of data expected for each. The ones shown in bold red are required fields which cannot be blank.

itemname Enter the name of your item here.
Max: 80 characters
Example:  Acme Magic Widget, Rare Platinum Edition 
qty The number of units you have for sale. It is important to keep this number as current as possible to avoid oversold situations which may irritate your customers. Note: A zero (0) value entered here will delete that item from your inventory until it is resubmitted with a positive quantity value.
Range: 0 ~ 9999
Example:  25 
price The lowest price at which you're willing to sell your item, in US dollars. Should consist only of digits and a single decimal point. Dollar signs ($), commas (,) and other characters should not be entered. If you would like to offer a "free" item, set the price here to "0.00".
Range: 0.00 ~ 9999999.99
Example:  79.95 
condition A numeric value which corresponds to the condition of your item. This should be set as accurately as possible to assure no disappointments upon delivery to your Buyer.
  • 1 = Brand New (still sealed in original packaging, never used)
  • 2 = Used - Like New
  • 3 = Used - Excellent
  • 4 = Used - Good
  • 5 = Used - Fair
  • 6 = Used - Non-functional
  • 7 = Refurbished
  • 8 = Vintage
  • 9 = Antique
  • 0 = See Description
Range: 0 ~ 9
Example:  2 
mfr The manufacturer of your item. (If software or a book, enter the publisher here). Not a required field, but recommended, since Buyers will be able to find your item easier when searching products by manufacturer.
Max: 35 characters
Example:  Black & Decker 
shiptime The number of days after order receipt, that you agree to ship your product. If you ship within 24 hours, enter a zero (0) here. A numeral five (5) = 5+ days.
Range: 0 ~ 5
Example:  1 
shipto The geographic region you are willing to ship your product to.
  • Worldwide
  • USA 50 States
  • USA Lower 48 (all states except Alaska & Hawaii)
  • USA/Canada
  • USA/Canada/Mexico
  • Originating Country Only
  • Local Pickup Only (if you cannot/will not ship the item)
Example:  USA Lower 48 
shipping_reg The price you charge for cheapest, economy shipping. Typically this will be USPS Media Mail, 1st-Class, UPS Ground, or Fedex Ground. Only digits and a single decimal point should be entered. No commas (,) dollar signs ($) or other characters are allowed.

Set this to "0" for Free Shipping.
Range: 0 ~ 9999.99
Example:  4.00 

shipping_exp The price you charge for domestic Express shipping, typically Fedex or UPS 2-Day Air, or USPS ExpressMail. Leave blank if you don't offer Express shipping.
Range: .01 ~ 9999.99
Example:  14.00 
shipping_intl The price you charge for International (foreign) shipping, typically US Postal Airmail or UPS/DHL/Fedex International Air. Leave blank if you don't offer International shipping.
Range: .01 ~ 9999.99
Example:  24.50 
method_reg The shipping method you use for domestic, economy shipping.
  • USPS 1st-Class Mail
  • USPS Priority Mail
  • USPS Parcel Post
  • USPS Media Mail
  • UPS Ground
  • Fedex Ground
  • Truck Freight
  • Ground
  • Air
  • Canada Post
  • Local Pickup
  • Digital Delivery

Example:  USPS 1st-Class Mail 
method_exp The shipping method you use for domestic, Express shipping. Leave blank if you don't offer Express shipping.
  • UPS 3-Day
  • UPS 2-Day
  • UPS Overnight
  • Fedex 3-Day
  • Fedex 2-Day
  • Fedex Overnight
  • DHL Express
  • USPS Priority Mail
  • USPS ExpressMail
  • XpressPost

Example:  DHL Express 
method_intl The shipping method you use for International (foreign) shipping. Leave blank if you don't offer International shipping.
  • USPS Global 1st-Class Mail
  • USPS Global Priority Mail
  • USPS Global ExpressMail
  • Fedex International Air
  • UPS International Air
  • DHL International Air
  • XpressPost International
  • Canada Post International
  • Other International Air
  • Digital Delivery

Example:  USPS Global Priority Mail 
image The URL location of your item's primary image. This should be the full URL, beginning with "http://". Not required, but highly recommended, since studies have proven that images sell products! All images should ideally be more than 500 pixels in width.
Allowable image types: .jpg .gif and .png NOTE: Images hosted on PhotoBucket.com will be rejected. Only non-interference image hosts may be used. Max: 150 characters
Example:  http://www.imagehost.com/images/widget1.jpg 
image_2 The URL location of your item's 2nd image.
Max: 150 characters
Example:  http://www.imagehost.com/images/widget2.jpg 
image_3 The URL location of your item's 3rd image.
Max: 150 characters
Example:  http://www.imagehost.com/images/widget3.jpg 
image_4 The URL location of your item's 4th image.
Max: 150 characters
Example:  http://www.imagehost.com/images/widget4.jpg 
image_5 The URL location of your item's 5th image.
Max: 150 characters
Example:  http://www.imagehost.com/images/widget5.jpg 
image_6 The URL location of your item's 6th image.
Max: 150 characters
Example:  http://www.imagehost.com/images/widget6.jpg 
upc The UPC or ISBN barcode number of your product. Entering this number will make your items highly visible, as shoppers will be able to see your listings when they do price comparisons for identical items from competing vendors. Should be entered without spaces, dashes or other special characters. Only a contiguous string. UPC numbers are typically 12 digits, while ISBN numbers are typically 10 or 13 digits, and are used to identify books.
Example:  001235557825 
sku Stands for "stock keeping unit". A unique product identifier used to differentiate your item from all others in your inventory. Can be a combination of alphanumeric characters, spaces, hyphens, underscores and forward slashes. Must be unique to a particular product, and cannot duplicate other SKUs in your inventory.
Max: 55 characters
Example:  WIDG-07blu 
description Your full product description. If it contains quotation marks within the body of the text, the entire field must be enclosed by quotes ("..."). Any embedded quotation marks must then be "escaped" by converting them to double quotes ("") or double apostrophes (''). Most spreadsheet apps like Excel do this automatically, but you should verify this by viewing the upload file after it's created by your spreadsheet. The description text also should not include any line breaks, line feeds, or carriage returns. It must all be included on a single, unbroken line within your upload file. Basic HTML permitted, including: <p><br><b><i><ul><ol><li><blockquote>.
Max: 10,000 characters
Example: (Line breaks shown here for illustrative purposes only)
"This <b>beautiful</b> chrome-plated widget certainly isn't short on features:
<li>Upper and lower vanity slots
<li>Inner thermal barrier
<li>15"" bottom feeder lever
<li>your choice of purple, red, or black side marker plates
<p> Only a few left in stock, so order now!"
notes Any additional information you'd like to add which isn't covered in the description. It could be a note about how fast you ship, or about a unique detail of the product, or how long you've been in business, etc.
Max: 80 characters
Example:  We ship same day! See our store for more discounts. 
specs Product attributes for your item. This might include the item's shipping weight, color, size, etc. Entering this information can enhance your product's visiblity in Google searches by using the data as additional Google attributes. Each attribute group must be separated by a pipe (|) symbol.
  • Age Range
  • Artist
  • Color
  • Gender
  • Length
  • Material
  • Model #
  • Part #
  • Size
  • Weight
  • Width
  • Youtube
Parameter Example
years 6-12
Kurt Cobain
inches 17.5
iPhone 3G
pounds 1.2
inches 5
11-char video ID _O2aVaqKD7g
Max: 12 fields, 255 characters total
Example:  Length: 7|Youtube: 34_gXl39aQr|Gender: Unisex 
warranty Detailed warranty information about the product.
Max: 255 characters
Example:  180-day factory warranty provided by Black & Decker 
reg_price The regular or "retail" price of your item. Entering a value here will create the addition of a "Savings" quote on your product page, showing the dollar amount a Buyer is saving vs. paying the item's regular price. Price must be set higher than your item's price value. As always, no dollar signs, commas or other characters besides numerals and a single decimal point.
Range: .01 above price ~ 9999999.99
Example:  109.99 
sale_expdate When used in conjunction with the reg_price field, creates a red "On Sale" sign on your product page, as well as the expiration date of the sale. On this date, the price defined by your price field will automatically switch over to the reg_price value. Sale expiration dates can be extended by changing the date in future uploads, or by manually editing the item from your Inventory page. Date must be entered using format: YYYY-MM-DD
Example:  2009-12-31 
category Primary shopping category for your product.
  • Art
  • Automotive
  • Baby
  • Books
  • Camera & Video
  • Cellular
  • Clothing & Accessories
  • Collectibles
  • Computers
  • Crafts
  • Dolls & Bears
  • Electronics
  • Food & Nutrition
  • Health & Beauty
  • Home & Garden
  • Jewelry
  • Movies & TV
  • Music
  • Office & Industrial
  • Pet Supplies
  • Software
  • Sports & Outdoors
  • Sports Memorabilia
  • Tools
  • Toys & Hobbies
  • Video Games
  • Everything Else
  • Bargain Basement

Example:  Electronics 
subcategory Secondary, sub-category for your product. This is a more specific subset of the main category, designed to make searches for specific products more accurate. A complete list of categories, subcategories and sub-subcategories is available for download.
Example:  Gadgets & Widgets  (as a subset of Electronics)
subsub Third-level, sub-subcategory for your product. This is a more specific subset of the subcategory field, designed to add an additional layer of definition to your product's item type.
Example:  Turbo Widgets  (as a subset of Gadgets & Widgets)
storecat A custom category which will be visible to shoppers on your Storefront page. This category can be anything of your choosing, and allows you to customize a buyer's browsing experience by directing them to specific areas of your store that might not be covered by our standard category structure.
Example:  Acme Products 
auctionmode Set this value to enable auction bidding for your listing. Hybrid mode makes the item available for immediate purchase, as well as auction bidding. Auction mode makes the listing auction-only, and the item can only be purchased by bidding and waiting for the auction to end.
  • Hybrid
  • Auction

Example:  Hybrid 
maxbids If your listing is auction-enabled, the number of bids required to end the auction.
  • 2
  • 5
  • 10

Example:  5 
reserve If your listing is auction-enabled, the reserve price for your item. With this value set, your item will not sell unless a buyer bids an amount equal to or higher than your secret reserve amount. To set your auction to No-Reserve, leave blank or enter '0'. No-reserve items will sell at the highest bid price at auction end, regardless of amount.
Example:  59.00 

For more information regarding the correct formatting of your upload files, refer to the photo tutorial in the right column on this page, visit our Community Forum Help Center, or email us at support@atomicmall.com.


Open Excel (or similar spreadsheet) and click on
File > Open

Navigate to the file containing your header data, select it, and click Open

When the Import Wizard appears, select Delimited and click Next

When prompted for delimiter type, select Tab and click Finish

Begin populating your fields with data. Your header will be shown in row 1, and your data fields will begin at row 2. Be sure to save your work often to avoid accidental data loss!

When entering product specs, each field must be separated by a pipe (|) character. Also, since we're using Excel in this example, we don't need to convert the single quotes to double quotes. If you use a text editor or other app which doesn't convert them for you, you'll need to do this manually, and enclose the entire field in quotes.

When finished entering product data, click File > Save As

Give your file a name, and select Text (Tab delimited) by the by "Save as type:" prompt. Then click Save. Note: You may get a warning that your file "may contain features that are not compatible with Text". If so, disregard by clicking Yes

Go to the AtomicUploader page and click the Browse button to locate your file.

Navigate to your file, select it and click Open

Click the Upload Inventory button to send your inventory file to Atomic Mall. Total upload and processing time will vary, depending on file size and internet connection speed. Maximum file size is 10mb, so if your data file is larger, you'll need to break it up into two or more sections and upload each separately.

If your upload is successful, the green checkmark will show. Your data file will then be placed in a queue, and processed along with other uploads in the order received. When your upload is scanned and processed, you'll receive an email notification indicating your listings are live. Allow up to 24 hours for processing.

By clicking the Uploader Results button from your Account page, or going to http://www.atomicmall.com/uploadresults.php, you'll be able to see a report of your last five AtomicUploader sessions, along with descriptive error reports for any lines that were not processed correctly. The reports will contain information about the type of errors encountered (if any), and how to correct them.

By clicking the Inventory button from your Account page, or going to http://www.atomicmall.com/inventory.php, you'll be able to see a complete list of your active items. If your recent upload was successful, the item(s) will show up here shortly after upload, and will be live and searchable on the site.

Copyright © 2008-2019 Atomicmall.com, All Rights Reserved