# Product Data

This may be used as an Import or an Export.

### Export

Use these filters to limit which columns are exported.

[![image.png](https://bookstack.iconography.co.uk/uploads/images/gallery/2025-10/scaled-1680-/8vDimage.png)](https://bookstack.iconography.co.uk/uploads/images/gallery/2025-10/8vDimage.png)

Use the filters to narrow your selection, then click 'Export'. This will generate a file that will include all Products that match your filters.

The export will include one row for each Variant linked to those Products.

[![image.png](https://bookstack.iconography.co.uk/uploads/images/gallery/2025-10/scaled-1680-/5JEimage.png)](https://bookstack.iconography.co.uk/uploads/images/gallery/2025-10/5JEimage.png)

#### Presets

It is possible to build Export presets. These provide a shortcut to which columns will be output.

You can either choose an existing preset from the drop down, or select 'new preset' If you do so, you will be prompted to enter a preset name, and select the required fields. That preset will then be available for future exports.

<p class="callout info">The SKU Code is always exported as the first column.</p>

### Import

Make changes to the file and import it to update Products.

When imported, the file will perform these two functions for each row:

1. If the SKU Code already exists in the database, then it will be updated as per the data in the spreadsheet
2. If the SKU Code does not exist, then a new Product will be created (see below for more details)

<p class="callout info">It is not possible to remove data using this method; blank cells will be ignored</p>

#### Merging Products

When creating a new Product, it is possible tomerge multiple rows into a Product with multiple Variants.

To do so, each row must share the same Name and ProdRef.

New Products with the same Name and ProdRef will be automatically merged on creation.

#### Field Summary

<table border="1" id="bkmrk-field-purpose-code-s" style="border-collapse: collapse; width: 100%; height: 4866.55px;"><colgroup><col style="width: 50.0477%;"></col><col style="width: 50.0477%;"></col></colgroup><thead><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Field</td><td style="height: 29.7969px;">Purpose</td></tr></thead><tbody><tr style="height: 104.188px;"><td height="19" style="height: 104.188px; width: 48pt;" width="64">code</td><td style="height: 104.188px;">*Sku Code (alphanumeric, mandatory, max 80 characters)*

<p class="callout info">*This field will not accept special characters; please limit your entries to letters, numbers, '-' and '.'*</p>

</td></tr><tr style="height: 87.3906px;"><td height="19" style="height: 87.3906px;">barcode</td><td style="height: 87.3906px;">*Barcode field (alphanumeric)*

<p class="callout info">*This will be autogenerated if left blank*</p>

</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">mpn</td><td style="height: 29.7969px;">*Manufacturer's Part Number (alphanumeric, stored per Variant)*

</td></tr><tr style="height: 104.188px;"><td height="19" style="height: 104.188px;">prodref</td><td style="height: 104.188px;">*Product Reference*

<p class="callout info">*This is used to link Products as separate Products, or to merge new Variants into a new Product (see above)*</p>

</td></tr><tr style="height: 35.3906px;"><td height="19" style="height: 35.3906px;">department</td><td style="height: 35.3906px;">*This powers the [Sales by Department](https://bookstack.iconography.co.uk/books/sales-reports/page/sales-by-department "Sales by Department") report (alphanumeric)*</td></tr><tr style="height: 46.5938px;"><td height="19" style="height: 46.5938px;">nominal</td><td style="height: 46.5938px;">*This field typically forms part of an integration with an accounts package*</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">commodity</td><td style="height: 29.7969px;">*Enter the Commodity Code of the product (for use with exports)*</td></tr><tr style="height: 63.3906px;"><td height="19" style="height: 63.3906px;">origin</td><td style="height: 63.3906px;">*Enter the Country of Origin (enter the country code, e.g. GB)*

*This is only required when exporting*

</td></tr><tr style="height: 197.766px;"><td height="19" style="height: 197.766px;">name</td><td style="height: 197.766px;">*The Name of the Product (mandatory)*

*Displays as the page title (also known as the H1 Text) and is also output on Product Listing Pages, as well as being the primary field for search results*

*Also used as the Meta-Title by default*

  
*This may be used to merge new Variants into a new Product (see above)*

</td></tr><tr style="height: 57.7812px;"><td height="19" style="height: 57.7812px;">manufacturersproductname</td><td style="height: 57.7812px;">*If populated, this will replace the Product Name on all [Purchase Orders](https://bookstack.iconography.co.uk/books/purchase-orders "Purchase Orders")*</td></tr><tr style="height: 63.3906px;"><td height="19" style="height: 63.3906px;">price</td><td style="height: 63.3906px;">*The selling price of the Variant*

*Defaults to 0*

</td></tr><tr style="height: 68.9844px;"><td height="19" style="height: 68.9844px;">rrp</td><td style="height: 68.9844px;">*The RRP of the [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants"), to show on the website*

*Defaults to 0*

</td></tr><tr style="height: 102.578px;"><td height="19" style="height: 102.578px;">offerprice</td><td style="height: 102.578px;">*A retail offer price for the [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") (this will supersede the Retail field), if enabled by the Offer Start/Expiry*

*Defaults to 0*

</td></tr><tr style="height: 80.1875px;"><td height="19" style="height: 80.1875px;">offerstart</td><td style="height: 80.1875px;">*Date until which the Retail/Trade Offer price should apply*

*If left blank, the Retail/Trade Offer price will apply unless an start date has been set in the future*

</td></tr><tr style="height: 80.1875px;"><td height="19" style="height: 80.1875px;">offerexpiry</td><td style="height: 80.1875px;">*Date from which the Retail/Trade Offer price should apply*

*If left blank, the Retail/Trade Offer price will apply unless an expiry date has been set in the past*

</td></tr><tr style="height: 204.953px;"><td height="19" style="height: 204.953px;">costprice</td><td style="height: 204.953px;">*The cost price of the [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants")*

*Defaults to 0*

*May be set per [Supplier](https://bookstack.iconography.co.uk/books/categories/page/suppliers "Suppliers") enabled for this Product*

<p class="callout info">*This may only be used if the Product is linked to a single Supplier. If there are multiple Suppliers, you will need to use the [Cost Price](https://bookstack.iconography.co.uk/books/import-export/page/cost-price "Cost Price") import.* </p>

</td></tr><tr style="height: 165.203px;"><td height="19" style="height: 165.203px;">vat</td><td style="height: 165.203px;">*Select the VAT status of this [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") - choose from:*

- *Standard*
- *Reduced*
- *Zero*
- *Exempt*

*VAT rates for Standard and Reduced are controlled via [Countries](https://bookstack.iconography.co.uk/books/countries "Site Settings")*

</td></tr><tr style="height: 124.969px;"><td height="19" style="height: 124.969px;">lowstock</td><td style="height: 124.969px;">*Use this to set a low stock threshold, e.g. '7'*

*If the stock level is below this level, a warning will be show on your website and the [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") will appear within the [Low Stock](https://bookstack.iconography.co.uk/books/stock-reports/page/low-stock) report*

*This will also be used to drive [Replenishment](https://bookstack.iconography.co.uk/books/replenishment)*

</td></tr><tr style="height: 68.9844px;"><td height="19" style="height: 68.9844px;">highstock</td><td style="height: 68.9844px;">*Use this to set a minimum stock level, e.g. '5'*

*This will be used to drive [Replenishment](https://bookstack.iconography.co.uk/books/replenishment)*

</td></tr><tr style="height: 52.1875px;"><td height="19" style="height: 52.1875px;">stocktext</td><td style="height: 52.1875px;">*A label that will display on the [Product Detail Page](https://bookstack.iconography.co.uk/books/product-detail-page "Product Detail Page") if this [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") has been selected*</td></tr><tr style="height: 57.7812px;"><td height="19" style="height: 57.7812px;">allowbackorder</td><td style="height: 57.7812px;">*This sets whether the [Product](https://bookstack.iconography.co.uk/books/categories/page/product "Product") may be sold without stock, e.g. [Sales Orders](https://bookstack.iconography.co.uk/books/sales-orders "Sales Orders") will be fulfilled by a back to back [Purchase Order](https://bookstack.iconography.co.uk/books/purchase-orders "Purchase Orders") (yes/no)*</td></tr><tr style="height: 68.9844px;"><td height="19" style="height: 68.9844px; width: 48pt;" width="64">allowpreorder</td><td style="height: 68.9844px;">*This will determine whether stock 'on the water', e.g. on a submitted [Purchase Order](https://bookstack.iconography.co.uk/books/purchase-orders "Purchase Orders") that has not yet been received, will be displayed as available stock on your website (yes/no)*</td></tr><tr style="height: 96.9844px;"><td height="19" style="height: 96.9844px;">postagetypes</td><td style="height: 96.9844px;"> *Enter postage type 'codes' in a comma delimtied list, e.g. 'standard,collect'.*

*Default postage types will be applied automatically to new Products*

</td></tr><tr style="height: 80.1875px;"><td height="19" style="height: 80.1875px;">deliverytext</td><td style="height: 80.1875px;">*Text entered in this field will display to the customer on the website if the product has available free stock*

*If left blank, this will default to 'In Stock'*

</td></tr><tr style="height: 119.375px;"><td height="19" style="height: 119.375px;">deliverytext2</td><td style="height: 119.375px;">*Text entered in this field will display to the customer on the website if the product does not have available free stock*

*If left blank, this will default to 'Out of Stock', or, if enabled for allowbackorder on the [Inventory](https://bookstack.iconography.co.uk/books/categories/page/inventory "Inventory") tab, it will default to 'Available (allow XXXXXX days for delivery)'*

</td></tr><tr style="height: 35.3906px;"><td height="19" style="height: 35.3906px;">leadtime</td><td style="height: 35.3906px;">*Set the leadtime (total days) for the [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants")*</td></tr><tr style="height: 109.781px;"><td height="19" style="height: 109.781px;">brandname</td><td style="height: 109.781px;">*This adds a [Brand ](https://bookstack.iconography.co.uk/books/brands "Brands")to a product*

<p class="callout info">*This will text match to an existing entry; if a matching entry does not exist, it will be created*</p>

</td></tr><tr style="height: 200.969px;"><td height="19" style="height: 200.969px;">supplier</td><td style="height: 200.969px;">*This section is used to add [Suppliers](https://bookstack.iconography.co.uk/books/suppliers) for a product. If not manually set, the default is to apply none.*

<p class="callout info">*If you are using multiple Suppliers for a single product, these may be added as a comma delimited list*</p>

<p class="callout info">*This will text match to an existing entry; if a matching entry does not exist, it will be created*</p>

</td></tr><tr style="height: 126.578px;"><td height="19" style="height: 126.578px;">collection</td><td style="height: 126.578px;">*This section is used to add [Collections](https://bookstack.iconography.co.uk/books/collections "Collections") to a product. If not manually set, the default is to apply none.*

<p class="callout info">*This will text match to an existing entry; if a matching entry does not exist, it will be created*</p>

</td></tr><tr style="height: 120.984px;"><td height="19" style="height: 120.984px;">summary</td><td style="height: 120.984px;">*This field allows for a simple summary of the product, with simple formatting*

<p class="callout info">*This may be uploaded with HTML to apply basic formatting*</p>

</td></tr><tr style="height: 120.984px;"><td height="19" style="height: 120.984px;">description</td><td style="height: 120.984px;">*This field controls the Product Description; formatting may be added to this using the controls at the top of the screen*

<p class="callout info">*This may be uploaded with HTML to apply basic formatting*</p>

</td></tr><tr style="height: 85.7812px;"><td height="19" style="height: 85.7812px;">tab1 to tab 4</td><td style="height: 85.7812px;">*If populated, this will add a new product information tab onto the product page; this field will provide the title of that tab*

*This will display in the same manner as a [Global Tab](https://bookstack.iconography.co.uk/books/global-tabs "Global Tabs")*

</td></tr><tr style="height: 46.5938px;"><td height="19" style="height: 46.5938px;">tab1to tab 4 content</td><td style="height: 46.5938px;">*This will form the content of a custom tab; this is populated as per the Product Description*</td></tr><tr><td>Merge Tag Title</td><td>*The title used on linked eCommerce Products*

*Used in Conjunction with Product Reference*

<p class="callout info">*Note that this field is optional for linked Products*</p>

</td></tr><tr><td>Merge Tag</td><td>*The label used on linked eCommerce Products*

*If multiple Products have the same Product Reference, they will be linked to the eCommerce Customer if a Merge Tag Title and Merge Tag are entered*

*Used in Conjunction with Product Reference*

<p class="callout info">*Note that this field is mandatory for linked Products*</p>

</td></tr><tr style="height: 80.1875px;"><td height="19" style="height: 80.1875px;">pdftext</td><td style="height: 80.1875px;">*Text entered here will be the link text shown to the customer on your website**This will default to the file name, if left blank*

</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">videoid</td><td style="height: 29.7969px;">*Use this to determine the type of video (Youtube/Vimeo)*

</td></tr><tr style="height: 141.766px;"><td height="19" style="height: 141.766px;">videotype</td><td style="height: 141.766px;">*Enter the ID of the video that you want to attached to the product**You can find the video ID from the URL:*

*[https://www.youtube.com/watch?v=](https://www.youtube.com/watch?v=dQw4w9WgXcQ)<span style="background-color: rgb(248, 202, 198);">[dQw4w9WgXcQ](https://www.youtube.com/watch?v=dQw4w9WgXcQ) </span>*

*[https://vimeo.com/<span style="background-color: rgb(248, 202, 198);">794492622</span>](https://bookstack.iconography.co.uk/uploads/images/gallery/2024-09/ahsimage.png)*

</td></tr><tr style="height: 35.3906px;"><td height="19" style="height: 35.3906px;">weight</td><td style="height: 35.3906px;">*Dimension of the [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") (kg)*</td></tr><tr style="height: 35.3906px;"><td height="19" style="height: 35.3906px;">volume</td><td style="height: 35.3906px;">*Dimension of the [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") (m3)*</td></tr><tr style="height: 35.3906px;"><td height="19" style="height: 35.3906px;">unitwidth</td><td style="height: 35.3906px;">*Dimension of the [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") (cm)*</td></tr><tr style="height: 35.3906px;"><td height="19" style="height: 35.3906px;">unitdepth</td><td style="height: 35.3906px;">*Dimension of the [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") (cm)*</td></tr><tr style="height: 35.3906px;"><td height="19" style="height: 35.3906px;">unitlength</td><td style="height: 35.3906px;">*Dimension of the [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") (cm)*</td></tr><tr style="height: 35.3906px;"><td height="19" style="height: 35.3906px; width: 48pt;" width="64">unitheight</td><td style="height: 35.3906px;">*Dimension of the [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") (cm)*</td></tr><tr style="height: 108.172px;"><td height="19" style="height: 108.172px;">cartons</td><td style="height: 108.172px;">*The number of Cartons in which this [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") is delivered from your Supplier*

*This will determine the number of product labels which will be printed from the [Label Printing](https://bookstack.iconography.co.uk/books/label-printing) screen, or at [Goods In](https://bookstack.iconography.co.uk/books/goods-in)*

</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">productlive</td><td style="height: 29.7969px;">*Defines the Product Status (yes/no)*</td></tr><tr style="height: 169.766px;"><td height="19" style="height: 169.766px;">variantlive</td><td style="height: 169.766px;">*Sets whether this [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") is live*

*It is possible to have a Product with multiple Variants where some are not live*

*If all Variants are set 'Variant Live' to No, then the Product will be disabled.*

*Defaults to Yes*

</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">buyonline</td><td style="height: 29.7969px;">*Defines whether the Product can be bought online (yes/no)*</td></tr><tr style="height: 96.9844px;"><td height="19" style="height: 96.9844px;">visibility</td><td style="height: 96.9844px;">*By default, all products will be visible on your website, but this setting allows you to determine visibility of the product within the POS, or across multiple websites*

*Enter a comma delimited list, e.g. website/instore*

</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">featuredhome</td><td style="height: 29.7969px;">*Toggle to feature the product on the Home Page*</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">featured</td><td style="height: 29.7969px;">*Toggle to feature the product on Category Pages*</td></tr><tr style="height: 119.375px;"><td height="19" style="height: 119.375px;">freeshipping</td><td style="height: 119.375px;">*Determines whether this [Variant](https://bookstack.iconography.co.uk/books/categories/page/variants "Variants") receives free shipping*

*This will only apply to orders within which all items have this enabled*

*(yes/no)*

</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">disallowdiscounts</td><td style="height: 29.7969px;">  
</td></tr><tr style="height: 35.3906px;"><td height="19" style="height: 35.3906px;">swatchwizard</td><td style="height: 35.3906px;">*Toggle to enable the [Swatch Wizard](https://bookstack.iconography.co.uk/books/product-detail-page/page/swatch-wizard) (yes/no)*</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">multiswatch</td><td style="height: 29.7969px;">*Toggle to combine variants within the Swatch Wizard (yes/no)*

<p class="callout info">*This controls the following field against the Product: 'Combine variant and swatch selection in Swatch Wizard if applicable (enables "multiswatch")'*</p>

<p class="callout warning">*This will not be available if multiple layers of Variant option are on a product, e.g. 'Size' and 'Colour'*</p>

<p class="callout warning">*This will not be available if any live Variant has no Customisations*</p>

</td></tr><tr><td>previewswatch</td><td>*Enables [swatch preview panel](https://bookstack.iconography.co.uk/books/general/page/swatch-panel) (yes/no)*

*Made to Order Products only*

</td></tr><tr style="height: 91.375px;"><td height="19" style="height: 91.375px;">requestaswatch</td><td style="height: 91.375px;">*Toggle to enable the [Swatch Request Popup](https://bookstack.iconography.co.uk/books/product-detail-page/page/swatch-request-popup) (yes/no)**([Swatches](https://bookstack.iconography.co.uk/books/swatches "Swatches") must be enabled for the Swatch Request tool for this to function)*

</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">itemcondition</td><td style="height: 29.7969px;">*Choose if a product is 'New' or 'Used'*</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">meta\_title</td><td style="height: 29.7969px;">*Use this to set a manual Meta Title*</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">meta\_description</td><td style="height: 29.7969px;">*Use this to set a manual Meta Description*</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">meta\_keywords</td><td style="height: 29.7969px;">*Use this to set your Meta Keywords*</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">google\_product\_type</td><td style="height: 29.7969px;">*Use this to override the Google Category assigned to this product*

*May be left blank*

*By default, this will inherit the setting in the [Product's](https://bookstack.iconography.co.uk/books/categories/page/product "Product") parent [Category](https://bookstack.iconography.co.uk/books/categories/chapter/categories "Categories") (the Category that this is taken from will be clearly listed here as 'default')*

</td></tr><tr style="height: 46.5938px;"><td height="19" style="height: 46.5938px;">excludefinance</td><td style="height: 46.5938px;">*Baskets that include this Product will not be permitted to checkout with finance (eCommerce)*

</td></tr><tr><td>allowvatremoval</td><td>*Enables the ability to exempt this Product from VAT, either in the POS or the CMS*

</td></tr><tr style="height: 104.188px;"><td height="19" style="height: 104.188px;">option1 to 3 name</td><td style="height: 104.188px;">*Enter an Option Name for the Product*

<p class="callout info">*This will text match to an existing entry; if a matching entry does not exist, it will be created*</p>

</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">option1 to 3</td><td style="height: 29.7969px;">*Enter an Option Value for the Variant*</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">related</td><td style="height: 29.7969px;">*Enter a comma delimited list of SKU codes as Related items*</td></tr><tr style="height: 29.7969px;"><td height="19" style="height: 29.7969px;">upsells</td><td style="height: 29.7969px;">*Enter a comma delimited list of SKU codes as Upsells*</td></tr><tr style="height: 35.3906px;"><td height="19" style="height: 35.3906px;">productaddons</td><td style="height: 35.3906px;">*Enter a comma delimited list of [Addon](https://bookstack.iconography.co.uk/books/addons "Addons") SKU codes*</td></tr><tr style="height: 63.3906px;"><td height="19" style="height: 63.3906px;">prodid</td><td style="height: 63.3906px;">*Export only*

*This will export the Product ID of the selected Product*

</td></tr></tbody></table>

#### Mapping

You will need to map your data before it can be imported.

<p class="callout success">It is highly recommended that your import file should only include the columns for the fields that you are intending to edit, and nothing else.</p>

<p class="callout danger">Mistakes made here may have serious impact on your Product database.</p>