Customising Labels

Label Templates

The default label layouts are set in .vm template files which can be freely changed to suit your needs.

The label templates are held in:

Win 7/Vista: C:\Users\<your windows user>\AppData\Roaming\Bluefish Retail\Bluestore Live POS\terminal\templates

Win XP: C:\Documents and Settings\<your windows user>\Application Data\Bluefish Retail\Bluestore Live POS\terminal\templates

(note that on win xp and vista, the Application Data folder is hidden by default. To display it, open my documents and go to tools - folder options, go to advanced and click 'show hidden files and folders'.)

Apple Mac: <your user>/library/Bluestore Live POS/terminal/templates

You can change the default delivered templates or create new ones in the same folder. The template file names used by Bluestore Live POS are set in the terminal preferences.


Changing Label Layouts

Open the label template using a text editor (e.g. windows notepad).

Make simple text changes on the label or get creative using the flexible commands, parameters and flow control available.

Each line of the label can be configured using a number of different commands which are listed in the "customising receipts tutorial". 

An example would be setting up a new template for shelf edge labels.

Using the current default.vm as a basis, we've slightly customised the output to look like this:


Using this code:

@[bold]@[right]Price $currentPrice


Save the file with name shelfedge.vm and then set the template in terminal preferences.

Setting The Template Files Used for Each Label

To set the template file that will be used for each label, on Bluestore Live POS navigate to Tools - Preferences and scroll down to label printing. Each type of label can be maintained by selecting the required entry and clicking 'change option'.


Setting the Barcode Symbology




EAN-8 & EAN-13 Most commonly used in the UK, also used in worldwide retail, GS1-approved – International Standard ISO/IEC 15420

UPC-A & UPC-E Most commonly used in the US, also used in worldwide retail, GS1-approved – International Standard ISO/IEC 15420

UPC-E  allows the use of UPC barcodes on smaller packages where a full 12-digit barcode may not fit

CODE39 and CODE128 - Alphanumeric, non-coded and can be read by virtually all scanners on the market.


Changing the height of the barcode

If you're using a jpos driver for your label printer, the height of the barcode can be adjusted to fit your label. Navigate to your chosen label template (using the instructions and paths detailed at the top of this tutorial). Change the height measurement detailed in this line:


If you are using an OS/Local printer, you will need to change the height in the barcode symbology file specifically for the barcode type you have chosen.

If, your barcode symbology is set to EAN-13, for example, navigate to:

Win 7/Vista:

C:\Users\<your windows user>\AppData\Roaming\Bluefish Retail\Bluestore Live POS\terminal\data\pos\settings\symbology

Open the relevant file in Notepad or other text editor. In this example we will open file ean13.xml and change the height reference:



Have more questions? Submit a request


Article is closed for comments.
Powered by Zendesk