How to Use Placeholder Settings in Bluetooth USB Printer Plus

June 14, 2026 4 min read

If you’ve been typing your store name, address, or GST number by hand every time you print a receipt — this guide will save you hours. Bluetooth USB Printer Plus has a built-in Placeholder system that lets you set these values once and reuse them in every print template automatically.

This guide covers everything: what placeholders are, the two types, built-in shortcuts like [[date]] and [[counter]], and step-by-step instructions with real examples.

What Are Placeholders?

Placeholders are special tags you put inside your print templates. When you print, the app automatically replaces each tag with the real value — either from your saved settings or by asking you to type it before printing.

For example, instead of writing your shop name every time, you type [[company]] once in your template. Every time you print, it becomes Toko Berkah Jaya (or whatever name you saved).

Two Types of Placeholders

1. Static Placeholders — `[[double brackets]]`

Static placeholders are replaced automatically with a value you saved in the app settings. You set the value once and it fills in silently every print — no interruptions, no typing.

Best for things that rarely change:

Store name
Address
Phone number
GST / tax number
Website or email

Format: [[placeholder_name]]

2. Dynamic Placeholders — `#[[hash brackets]]`

Dynamic placeholders ask you for a value just before printing. A dialog pops up with input fields for each dynamic placeholder found in the template. You fill them in, tap Print, and done.

Best for things that change with every receipt:

Customer name
Order number
Quantity
Table number
Delivery address

Format: #[[placeholder_name]]

Built-in Automatic Placeholders

These work out of the box — no setup needed. Just type them in any template and they fill in automatically.

Placeholder	What it inserts	Example output
`[[date]]`	Today’s date	2026-06-14
`[[time]]`	Current time	14:32
`[[counter]]`	Auto-incrementing number (resets via settings)	001, 002, 003…

Tip: [[counter]] is perfect for token numbers and invoice serial numbers. It increments by 1 each time you print and always formats as a 3-digit number (001, 002 … 099, 100).

How to Create Custom Placeholders

Step 1 — Open Placeholder Settings

In the app, go to Settings → Placeholders. You will see two sections: Static and Dynamic placeholders.

Step 2 — Tap “Add Placeholder”

Tap the ＋ Add Placeholder button. A form appears with these fields:

Placeholder Name — a display name (e.g., Company)
Description — optional hint shown in the input dialog
Type — choose Static or Dynamic
Default Value — for Static: the value that gets printed (e.g., Toko Berkah Jaya)

Step 3 — Save

Tap Save. Your placeholder is now available in the Insert Placeholder menu inside every template.

Note: The placeholder tag is auto-generated from the name you enter. If you name it company, the tag becomes [[company]] for static or #[[company]] for dynamic.

How to Use Placeholders in a Template

Option A — Type the tag directly

In any template text area, just type the placeholder tag. For example:

TOKO BERKAH JAYA
[[address]]
Tel: [[phone]]

Date: [[date]]  Invoice: [[counter]]
--------------------------------
Customer: #[[customer_name]]
Items: #[[items]]
Total: #[[total]]
--------------------------------
Thank you for your purchase!

Option B — Use the Insert Placeholder menu

Tap the Insert Placeholder button in the template editor toolbar. Choose:

Static Placeholder [[]] → pick from your saved static list (or add a new one)
Dynamic Placeholder #[[]] → type the field name and it inserts #[[your_name]]

Real-World Examples

Example 1 — Shop Receipt with Auto Date and Counter

     [[company]]
   [[address]]
  Tel: [[phone]]
================================
Receipt No: [[counter]]
Date: [[date]]  Time: [[time]]
================================
#[[item1]] ... #[[price1]]
#[[item2]] ... #[[price2]]
--------------------------------
TOTAL: #[[total]]
================================
   Thank you. Visit Again!

What happens at print time: [[company]], [[address]], [[phone]] fill in from saved settings. [[counter]] auto-increments. [[date]] and [[time]] fill with the current date and time. A dialog prompts you to enter item names, prices, and total.

Example 2 — Token / Queue Number

     [[company]]
  Token Number
================
    [[counter]]
================
  [[date]] [[time]]
 Please wait for
  your number

Every time you print, the counter increments automatically — no typing needed. Great for clinics, service centres, and canteens.

Example 3 — Delivery Receipt

DELIVERY RECEIPT
[[company]] | [[phone]]
Date: [[date]]
----------------------------
To: #[[customer_name]]
Address: #[[delivery_address]]
----------------------------
Order: #[[order_details]]
Amount: #[[amount]]
----------------------------
Delivered by: #[[rider_name]]

The delivery agent fills in customer name, address, and order details before printing each receipt. Your company details and date fill automatically.

Tips for Using Placeholders Effectively

Set up static placeholders first. Start with company name, address, phone, and GST number — these go into almost every template.
Use [[counter]] for all sequential numbers. It auto-increments and formats consistently. You can reset it from Placeholder Settings any time.
Keep dynamic placeholder names short. They appear as labels in the input dialog. name is cleaner than customer_full_name.
Add descriptions. The description text appears as the hint inside the input field — makes it clear what to type, especially useful for staff.
Mix static and dynamic freely. A template can have any combination of [[static]] and #[[dynamic]] tags.

Download Bluetooth USB Printer Plus

Placeholder settings are available in Bluetooth USB Printer Plus on Google Play. The app supports Bluetooth and USB ESC/POS thermal printers on Android.

Techpuram

Thermal Printing & POS Experts