How do I bulk upload my products?

Our web console provides an easy way to upload hundreds or thousands of products in one go. This same tool allows you to keep your product catalogue up to date with price changes, de-listings, and other ongoing changes all in a single spreadsheet. Before you use this tool, it is best to upload a single product so that you understand what is being done behind the scenes. Here are the instructions for how to add a single product. Once you are done doing that, follow the instructions below to upload products in bulk.

To access the bulk upload tool:

  • Log in to the Onsight admin console at
  • Click on ‘Catalogue’ from the left-hand side menu.
  • Click on the ‘Manage Products’ menu item.
  • Click on the ‘Action’ button at the top of the screen and then click on ‘Import Products’.
  • This will open up the 4-step bulk upload tool.

Step 1: Download your data

If you have already got some product information in Onsight, then this step will download all that information for you so that you can make and upload changes. If you have no existing data you will need to download the datasheet anyway so that you will know how to structure your product datasheet for uploading into Onsight. So click the “Download” button and save the spreadsheet somewhere you will find it easily.

Step 2: Edit the datasheet

Each row in your spreadsheet represents one of your products. Each column contains some important information about your product. Let’s go through them one by one.

Onsight ID

Onsight ID is the unique number we give to each one of your products in the Onsight Database. Why is it in this sheet? Well, it helps us to know which products you want to update when you want to change your data. For example if you want to change the name, description, product code and other information relating to a specific product, we would not be able to know WHICH product’s information to change without the Onsight ID.

If you’re uploading new products, leave this column blank. If you’re updating existing ones, then keep the same Onsight ID that was downloaded in the sheet to start with.

Product Code, Barcode & SKU

Everyone uses different combinations of codes to track their products. You can use all three or none, it is up to you.

Product Name

Fill in the product name here.

Is Master & Master Product Name

Master products are used to group very similar products together. For example: if you sell t-shirts, and have a particular type of t-shirt called a Plain T, but it comes in different colours and sizes, then you could use a master product called “Plain T” and a variant for each option that you offer – “Plain T Red XL”, PLain T Blue S”, etc.

Do you have to? No, you can create a new product for each of your products – but using master products and variants can make things a little easier to manage over the longer term.

There are two important columns if you want to make use of master products and variants. Firstly, if the row represents a master product, then “Is Master” must be set to “Yes”  (it must be “No” if the product is a normal plain vanilla product or a Variant). Secondly, if the row represents a variant, then “Master Product Name” must contain the exact same name as the master product’s name.

Here is some sample master and variant data:




Image URL

Onsight is a visual selling tool so we need images for each of your products. We recommend that you first complete the rest of this document to upload all your product information without images and then afterwards you can upload your images. There are two ways to upload images in bulk. Please see this guide for detailed instructions on how to bulk upload your images.

Cost Price

Onsight has a report in the Reports module that displays your gross profits / margins for each product sold. To calculate this we need the cost price of each product. Use this field to add the cost of sales for the product.


Enter your product’s price here excluding any taxes. To create or manage taxes that must get applied to your products, please go to Setup > Configuration and click on the “Tax Types” tab.


Be as wordy as you like – this is your chance to get detailed product information distributed to all your sales reps.

Is Active

Set this field to “Yes” or “No”. Inactive items are withdrawn from the catalogue so they no longer get displayed.

Is Featured

Set this field to “Yes” or “No”. Featured items are given a more prominent display in your catalogue.

External ID

If you are using CSV files to copy data between Onsight and your internal system, you can use this field to store your internal system’s product ID. That way there can be a link between the product in Onsight and the product in your internal system. If you are not using CSV files to copy data between systems, you can leave this field blank.

Applied Taxes

If your products are taxable, then this is where you specify which taxes must be applied to the product. Of course, you need to have set up the taxes first. Then you can fill in the tax name into this field. To set up your taxes, follow this article.

Is Taxable

If your product is taxable, indicate this with ‘Yes’ or, if your customer is not taxable, indicate this with ‘No’ in this field.

Stock Availability

This is where you can specify the number of items in stock. This gets displayed in the product catalogue for the sales reps to see. See this guide on how to show accurate stock levels in the Onsight app.

Quantity Increment

If you have products with a specific pack size (the number of items that are sold in a case) then you can configure this product to be added to the order or quote in increments of the pack size. Fill in your pack size into this field. For example, if your pack size is 6, fill in 6 to be able to add items to the cart in increments of 6.

Minimum Quantity

Each product can have a minimum quantity per order or quote.

Maximum Quantity

Each product can have a maximum order quantity per order or quote.

Product Categories

Each product needs to live inside a category or sub-category. Enter the names of your categories in these columns to create your category structure and allocate each product to its proper place. Some rules to be aware of:

  • Categories cannot contain both subcategories and products. Therefore, if a category already has products in it, you can’t create a new subcategory, and if it already has subcategories you won’t be able to add products to it.
  • Master Products and Variants must both be in the same category.

Custom Fields

The custom field columns will only appear if you have defined custom fields for your products and if you have created some values for those custom fields. The columns will be named: ‘Custom Field Name’ and ‘Custom Field Value’ , etc. . Custom fields allow you to store additional information for each of your products. This will then be displayed in the catalogue on the mobile app. It can also be displayed on your orders and quotes. Custom fields can be added by inserting additional columns after the categories columns.

When entering non-text values such as dates, monetary amounts and numbers, the cells needs to be formatted as ‘Text’ before you type something into it so that whatever you type into the cells remain as you have typed it. If you do not do this, Excel will convert what you have typed into a date, monetary amount or number, and you will lose the formatting that you originally had.

Step 3: Upload Data Sheet

Save your file. Then select its location on your computer, and upload it to Onsight for processing.

Step 4: Import Product Catalog Data

Once you click the “Import” button your spreadsheet will be analysed and validated.

If your spreadsheet passes validation you will be shown a list of updates that will happen once you approve the import job, and you will be able to approve it so that the datasheet is actually processed and your product information imported. If the spreadsheet fails, you will be shown a list of errors to rectify before uploading it all again. If everything is OK – hit “Approve Job” and all your information will be imported into the database.

Check on your import jobs

To see the status of all your import jobs, go to Setup > Import Jobs and you will see them all listed.

Still have questions?

If you are still uncertain of how to proceed or if you encounter any problems email us at [email protected] and we will help you through the process step-by-step.