Skip to main content

Label Printing – Setup & User Guide

Print barcode and price labels for your stock directly from BikeBook using a Star Micronics CloudPRNT-compatible printer. Select items, customise label templates, and print in bulk — all from the Stock page.

Updated this week

What You Need

  • A Star Micronics CloudPRNT-compatible printer (e.g. TSP700II, TSP800II, mC-Print series)

  • The printer connected to your local network (Ethernet or Wi-Fi)

  • Label roll loaded in the printer (common sizes: 55×30mm, 40×30mm, 50×25mm, 76x38mm or custom sizes allowed)


Part 1: Setting Up Your Printer

Step 1: Find your printer's IP address

You need the printer's IP address to access its settings. There are a few ways to find it:

Option A: Self-test page (easiest)

  1. Turn the printer off.

  2. Hold down the FEED button.

  3. While holding FEED, turn the printer on.

  4. Release the button once it starts printing. The IP address will be printed on the diagnostic page — look for a line labelled "IP Address" or similar. See the images below to see what you are looking for.


Option B: Check via your router

Log in to your router's admin page (usually 192.168.1.1, 192.168.0.1, 192.168.1.254 or 192.168.0.254 ) and look at the list of connected devices. The printer will usually show up as "STAR" or its model name (e.g. "TSP700II").

Option C: Network scanner app

Use a free network scanning app (e.g. "Fing" on iOS/Android, or "Advanced IP Scanner" on Windows) to scan your local network. Look for a device with manufacturer "Star Micronics".

If you can't find the IP address:

  • Make sure the printer is connected to the same network as your computer (Ethernet cable or Wi-Fi, depending on your model).

  • If the printer is connected via Ethernet, check the cable is firmly plugged in at both ends and the network light on the printer's Ethernet port is active.

  • If the printer has a small display or indicator lights, check for error states.

  • Try restarting both the printer and your router.

  • If the printer still doesn't appear on the network, it may need a factory reset — consult the Star Micronics manual for your specific model.

Step 2: Log in to the printer's web interface

  1. Type the printer's IP address into your browser (e.g. http://192.168.1.50).

  2. You'll see a login prompt on the left side under System Access.

  3. Enter the credentials:

    • Username: root

    • Password: public (this is the default — change it if you'd like to secure the printer)

  4. Click Login.

This opens the Star printer's built-in configuration dashboard.

Step 3: Enable CloudPRNT and set the server URL

  1. In the left-hand menu, click on CloudPRNT (or look for it under the network/connectivity section).

2. Enable CloudPRNT (tick the checkbox or toggle).

3. Set the Server URL to:

https://api.bikebook.co.uk/api/cloudprnt

4. Click "Submit".

5. IMPORTANT: Make sure to click "Save" after you have submitted, this is required to save the configuraration. See image below for where they exist.

6. Choose "Save > Configuration printing > Restart device", this will take a few minutes to take effect.

Step 4: Note your printer's MAC address

The MAC address is a unique hardware identifier for your printer. You'll need it to register the printer in BikeBook.

You can find it in several places:

  • On the self-test printout from Step 1 (look for "MAC Address" or "Ethernet Address").

  • In the printer's web interface — usually on the main dashboard or under Network settings.

  • On a physical label on the bottom or back of the printer.

It looks something like: 00:11:62:1A:2B:3C , see below for where to find it on the Star utility page.

Step 5: Register the printer in BikeBook

  1. Go to Configuration → Printing.

  2. Click Add Printer.

  3. Enter a name (e.g. "Workshop Printer") and the MAC address.

  4. Click Register.

Step 6: Verify the connection

Once registered, the printer should appear in the list. After a few seconds it will show an Online status indicator (green). Click Test Print to confirm everything is working. If it says offline, try refresh the Workshop page. If it still says offline, please make sure all the steps above have been followed correctly.


Part 2: Creating Label Templates

Label templates control what appears on each label — product name, price, barcode, SKU, and more. You can create multiple templates for different use cases (e.g. a simple price label vs. a detailed stock label).

Creating a new template

  1. Go to Configuration → Printing.

  2. Scroll down to the Label Templates section.

  3. Click New Template.

The template editor

The editor has two panels:

  • Left panel: Live preview of the label with drag-and-drop field ordering.

  • Right panel: Settings for the selected field (font size, alignment, bold, barcode options).

Configuring your template

  1. Template name — Give it a descriptive name (e.g. "Default Price Label").

  2. Label size — Choose a preset (e.g. 55×30mm) or enter custom dimensions to match your label roll.

  3. Cut mode — Select how labels are separated (Full Cut, Partial Cut, or Feed to Black Mark depending on your paper type).

  4. Set as default — Toggle on if this should be pre-selected when printing.

Adding and arranging fields

Available fields for stock labels include:

Field

What it shows

Example

Product Name

The stock item name

Continental GP5000

Variation Name

The variation (if different from product name)

700x25c

Brand

Manufacturer/brand

Continental

Category

Stock category

Tyres

SKU

Your SKU code

SKU: GP5000-700

EAN

European Article Number

EAN: 4019238044874

UPC

Universal Product Code

UPC: 012345678905

Manufacturer SKU

Manufacturer's part number

MPN: 0101388

Price

Selling price (uses your business currency)

GBP 89.99

Cost Price

Your cost price

GBP 45.00

Location

Stock location

Shelf B3

Vendor / Supplier

Supplier name

Continental AG

Stock Qty

Remaining quantity

Qty: 12

Barcode

Scannable barcode with number underneath

(barcode image)

Custom Header

Your own text at the top

Your Shop Name

Custom Footer

Your own text at the bottom

Spacer

Blank gap between fields

(empty space)

  • Drag fields up and down to reorder them on the label.

  • Click a field to edit its settings (font size, alignment, bold).

  • Use the arrows to place two fields side-by-side on the same row (e.g. Price and Cost Price).

  • Remove a field by clicking the trash icon — it moves to the "Hidden Fields" section where you can re-add it later.

Field settings

When you select a field, the right panel shows its options:

  • Font size: Small, Medium, or Large — Large prints at double height and width.

  • Alignment: Left, Centre, or Right.

  • Bold: Toggle bold text on or off.

For Barcode fields, you also get:

  • Barcode type: Code 128 (default, most versatile) or other formats.

  • Height: Barcode height in millimetres.

  • Data source: Which value to encode — Barcode (EAN/UPC), SKU, or Custom.

Test printing from the editor

At the bottom of the editor, you can send a test print without leaving the page:

  1. Select a printer from the dropdown.

  2. Set how many test labels to print.

  3. Click Test Print.

Test labels use sample data so you can check the layout before printing real stock labels.

Save your template

Click Save in the bottom-right corner. You'll see a confirmation notification.


Part 3: Printing Labels

Step 1: Go to the Label Printing tab

Navigate to Stock → Label Printing. This shows your full stock library (including partner/supplier stock) with a quantity column for printing.

Step 2: Select items and set quantities

  • Tick the checkbox next to items you want to print. The quantity automatically sets to 1.

  • Use the + / − buttons or type a number directly to set how many labels per item.

  • Use the search bar and filters to find specific items. Your selections are preserved when you search or paginate — so you can build up a batch across multiple pages.

  • Clicking + on an unselected row will select it and set quantity to 1.

  • If the quantity reaches 0 (via − or clearing the field), the item is automatically deselected.

Step 3: Click Print Barcode Labels

The Print Barcode Labels button appears in the page header. It shows the total number of labels that will print (e.g. "Print Barcode Labels (5)"). Click it to open the print dialog.

Step 4: Review and print

The print dialog shows:

  1. Printer selector — Choose which printer to send the job to. Online printers are indicated with a green status dot.

  2. Label template selector — Pick the template to use. The default template is pre-selected.

  3. Template preview — A visual preview of what the label will look like with the selected template.

  4. Selected items list — All items you selected with their quantities. You can adjust quantities here or remove items. Click Remove all to clear the selection.

  5. Print Labels button — Sends the job to the printer.

Step 5: Watch the print progress

After clicking Print Labels, the dialog shows real-time progress:

  • Sending → Job is being sent to the server.

  • Queued → Job is waiting for the printer to pick it up.

  • Downloading → The printer is downloading the label data.

  • Printing → Labels are being printed.

  • Complete → All done! A summary shows the printer used, template, and total labels printed.

If something goes wrong, you'll see an error message. Common causes: printer offline, printer out of paper, or a network issue.


Tips & Best Practices

  • Start with the default template and adjust from there. It includes Product Name, SKU, Price, and Barcode — the most common setup.

  • Use "Large" font size for the price so customers can read it at a glance.

  • Bold the product name to make it stand out.

  • Test print before bulk printing — use the test print feature in the template editor to check layout before committing to hundreds of labels.

  • Custom header is great for your business name — it prints at the top of every label.

  • Side-by-side fields work well for Price + Cost Price, or SKU + Location, saving vertical space on small labels.


Troubleshooting

"No printers available"

Your printer isn't registered or isn't connected. Go to Configuration → Printing and check:

  1. Is the printer registered? (Add it if not.)

  2. Is it showing Online? If not, follow the "Printer shows Offline" steps below.

Printer shows "Offline"

Work through these checks in order:

  1. Is the printer powered on? Check for indicator lights.

  2. Is it on the network? Check the Ethernet cable is connected, or that Wi-Fi is configured. The network light on the Ethernet port should be active.

  3. Can you access the web interface? Type the printer's IP into your browser. If you can't reach it, the printer may have a different IP (try the self-test page again) or there's a network issue.

  4. Is CloudPRNT enabled? Log in to the printer's web interface (username: root, password: public) and check CloudPRNT is turned on.

  5. Is the Server URL correct? It must be exactly: https://api.bikebook.co.uk/api/cloudprnt — no trailing slash, no typos.

  6. Restart the printer. Power-cycle it and wait up to 30 seconds. The printer polls the server every few seconds, so it should come online shortly after restarting.

  7. Check your network/firewall. The printer needs outbound HTTPS access (port 443) to api.bikebook.co.uk. Some corporate firewalls block this — check with your IT team if applicable.

Can't access the printer's web interface

  • Double-check the IP address by printing a self-test page.

  • Make sure your computer is on the same network as the printer.

  • Try a different browser or clear your cache.

  • If the IP has changed (e.g. after a router restart), your router may have assigned a new one. Use a network scanner or check your router's device list.

  • Consider assigning a static IP to the printer (via the printer's web interface under Network settings) so it doesn't change.

Labels are blank or cutting incorrectly

  • Check the label size in your template matches the actual label roll size.

  • Check the cut mode setting — use "Feed to Black Mark" for black-mark label rolls, or "Full Cut" / "Partial Cut" for continuous rolls with a cutter.

Text is too small / too large

  • Edit the template and adjust font size per field (Small / Medium / Large).

  • Make sure your label dimensions are correct — a 40mm wide label has much less space than a 55mm one.

Price shows wrong currency

  • Go to Configuration → Settings → Invoice Settings and check the Currency setting is correct for your business.

  • The label uses your business's configured currency (e.g. GBP, EUR, USD).

Print job stuck on "Queued"

  • The printer may be offline or busy. Check its status in Configuration → Printing.

  • Try power-cycling the printer.

  • If the issue persists, check that the printer's CloudPRNT polling is active (the printer should poll every few seconds).


NEED HELP?

If you're still having issues, reach out to support and we'll be happy to help you get set up.

Did this answer your question?