Label Designer

Service Label Designer addon WHMCS

Order now | Download | FAQ

The Label Designer page is available at: Addons > PUQ Service Label Designer > Designer

This is the main page of the module where you configure label templates for each product group.

Label Designer — template editor with per-group configuration 04-designer.png

Page Layout

The page consists of several sections:

Top Bar

Import — import settings and templates from a JSON file
Export — export all settings and templates to a JSON file
Save — save all changes

Available Variables

A reference panel listing all template variables you can use. See Configuration for a detailed description of each variable.

Bulk Operations

Enable All List / Disable All List — check or uncheck all "Enable in List" checkboxes
Enable All Invoice / Disable All Invoice — check or uncheck all "Enable in Invoice" checkboxes

Groups Table

The main table lists all product groups from WHMCS with the following columns:

Column	Description
ID	Product group ID
Group Name	Name of the product group
Products count (cube icon)	Number of products in this group
Enable in List (list icon)	Checkbox — enable overwriting service names in client area
Overwrite List Text	Template for the client area services list. Supports HTML and template variables
Enable in Invoice (invoice icon)	Checkbox — enable adding custom text to invoice descriptions
Invoice Text	Invoice mode selector and template. Supports HTML and template variables

Overwrite List Text

When the Enable in List checkbox is checked for a group, all services belonging to products in that group will have their names replaced in the client area "My Products & Services" page.

The template supports:

All template variables (e.g., {product-name}, {service-domain})
Full HTML (e.g., <b>, <span style="...">, <br>, <table>)
Any combination of text and HTML

Example template:

<b>{product-name}</b> <span style="color:#999">({group-name})</span><br>
<small>{service-domain} &mdash; {service-dedicatedip} | {service-assignedips}</small>

Invoice Text

When the Enable in Invoice checkbox is checked, the module modifies invoice line item descriptions for services in that group.

Invoice Mode

Each group has a mode selector above the invoice template textarea:

Mode	Behavior
Append	Adds the template text after the original invoice description (on a new line)
Replace	Replaces the original invoice description entirely with the template text
Prepend	Adds the template text before the original invoice description (on a new line)

Example (Append mode):

Original: Mikrotik VPN 10M/10M/10GB (01/03/2026 - 31/03/2026) Template: {product-name} ({group-name}) — | User: {service-username} | IP: {service-dedicatedip}

Result:

Mikrotik VPN 10M/10M/10GB (01/03/2026 - 31/03/2026)
Mikrotik VPN 10M/10M/10GB (Mikrotik VPN) — | User: 1-5525 | IP: 192.168.222.2

Preview

Each template textarea has a preview button (eye icon). Click it to see how the template renders with real service data from that group.

Preview modal — rendered template with real service data 05-preview.png

Service ID — which service was used for the preview
Rendered result — the template with all variables replaced by actual data

Note: The preview uses the current textarea content (not saved data), so you can test your template before saving.

Export / Import

Export

Click the Export button to download a JSON file containing:

All configuration settings (default values)
All group templates and settings (enable flags, modes, template text)

Import

Click the Import button and select a previously exported JSON file. The import will:

Overwrite all configuration settings
Replace all group templates and settings

Warning: Import replaces all existing settings. Export your current settings first if you want to keep them as a backup.

This feature is useful for:

Migrating settings between WHMCS instances
Backing up your configuration before making changes
Sharing templates between environments (dev/staging/production)