VolunteerHub can be configured to integrate with your Brother QL-700/800 series label printer, which can be triggered manually in the OnSite App or automatically when a user checks in via the Kiosk. This feature also works with QR check-in, and allows you to print labels using your own custom nametag design on various label sizes.
The Label Printer Integration is an optional feature that must be enabled by our support team. The integration can only be purchased for sites that already have the OnSite/Kiosk app. The Label Printer Integration is included at no additional charge for Enterprise plans and can be purchased for other plans with a one-time set-up/implementation fee. For more information on how you can integrate your Brother label printer with VolunteerHub's OnSite/Kiosk app, please contact email@example.com.
This article covers the following topics:
This feature allows you to:
- Print to a single printer from multiple check-in stations
- Check users in and print a name tag in a matter of seconds
- Team multiple printers together for high-volume application
- Print nametags at multiple check-in locations
Note that the printer must be physically connected to a computer/device with an internet connection.
The printer integration requires that your Brother QL-700/800 series printer be connected to a computer, on which the integration software will be installed so it can speak to your VolunteerHub site. The requirements for the computer connected to the printer are as follows:
- The machine on which the printer is installed and running the integration software MUST have Windows 7 or later with Microsoft .NET Framework version 4.5.2 or later.
- While the OnSite/Kiosk device can be any tablet or computer, the printer must be connected to a computer running Windows (tablets and Apple devices not currently supported).
- The printer must be connected to the computer via USB (recommended) or wireless connection.
- The computer connected to the printer must be turned on for the duration of the event check-in period.
- The administrator running the label printer application must be logged into VolunteerHub as a Superuser on the computer connected to the printer. The same Superuser account above must be logged in each time the label printer integration is used.
- The printer's power-saving mode must be disabled via the Printer Properties menu in the computer to which the printer is connected (instructions below).
While many organizations may use the computer described above as the OnSite/Kiosk device, you may have volunteers check in on other devices (e.g., tablets/iPads or computers). Any number of devices may be used to check volunteers in, and the printer will be able to print nametags for users checking into any of those devices at once. The printer does not need to be installed/connected to those devices; it only needs to be installed on one computer as described above.
Figure 1 below provides a diagram of the recommended device layout. Note that the computer and printer are the only two required devices (and therefore the computer may be used as the Kiosk itself). Additional tablets and/or computers used for OnSite/Kiosk check-in are optional.
Figure 1. Recommended integration device layout.
Follow the steps below to get started installing and using the Label Printer Integration. To complete this process, you will need to have requested the feature for your site.
Step 1. Install the printer.
- Connect the printer to your Windows PC or laptop using the USB cable provided with your printer.
- Download the required installation files and the driver software from the manufacturer's support site.
- Disable your printer's sleep mode, per instructions for your printer model. For the 700 series printer:
- From the Start Menu, go to Printers.
- Select the QL-700 series printer and choose Manage. (If the printer driver wasn't installed properly, it will appear as an Unspecified device. Be sure that you downloaded the driver software for your model from the link in #2 above.)
- Select Printer properties.
- Click on the Device Settings tab.
- Click on Utility to reveal the Properties button.
- Click on the Properties button.
- In the Auto Power-Off section, select "0" from the Time field.
- Click on the Apply button.
- Click on the Exit button.
- WIRELESS ONLY: If you plan to use the printer's wireless mode (not recommended), follow the manufacturer's instructions to set up wireless printing. Once you are able to successfully print a test label, the installation is successful.
The above are prerequisites to the integration - installing your printer DOES NOT install the integration, as there is additional integration software that must be provided by our support team to continue with installation.
Step 2. Install the SDK and VolunteerHub Label Printer Monitoring software.
- Download and install the latest version of the 32-bit b-PAC SDK for developers from Brother’s website. The 64-bit version will not work.
- Download and install our VolunteerHub Label Printer software via the link provided by our support team. (If your organization has a current Enterprise plan, please Send a Message to Support to request access to this software. If your organization has a current Plus or Pro plan, please email firstname.lastname@example.org to purchase the Label Printer Integration first, as it is not included with OnSite/Kiosk.)
Step 3. Create your label (nametag) template.
Most Brother QL-700/800 series label printers allow you to print either small (1.1 x 3.5") or large (2.4 x 3.9") labels using the P-touch Editor software included with the printer (Figure 2). You can design your own label, or download one of our quick templates by clicking on one of the links below.
NOTE: The below templates will not download properly in Internet Explorer. Please use Firefox or Chrome to download them.
Figure 2. You can download our large or small label template.
To merge volunteer and event information from your VolunteerHub site into the label, click on a text field in the label and click on the small Properties icon in the toolbar (highlighted in Figure 3 below). Click on the Expanded tab in the Text Properties dialog box that appears. In the Object Name field, enter the VolunteerHub field you would like to merge into the label, then click OK.
The following Object Names can be used to merge event and user details into the nametag as volunteers check in:
- id: The user's GUID, typically only used for barcode applications
- username: The user's username
- firstname: The user's first name
- lastname: The user's last name
- name: The user's first and last names
- pronouns: The user's Preferred Pronoun, if included in user form
- eventname: The name of the event
- eventlocation: The location provided for the event
- eventstarttime: The start time of the event (e.g., "8:00 AM")
- eventendtime: The end time of the event (e.g., "5:00 PM")
- usergroupname: The user group with which the user is affiliated for the event (if registered under a group reservation)
Figure 3. Merge VolunteerHub fields into your labels in P-touch Editor.
Once you're finished building your label template, save it.
If you own a QL-800 series printer that uses red-and-black tape, you must open the label template in P-Touch editor, click the "Paper" tab and turn on the "2-color mode" (Black/Red), then save the template.
Step 4. Run the VolunteerHub Label Printer software.
On the computer your label printer is installed on, log into your VolunteerHub site as a Superuser. Then, open the VolunteerHub Label Printer software you downloaded in Step 2 above and follow the instructions below.
- Give your printer a name in the Name field (e.g., “Lobby Printer 1”).
- Enter your entire VolunteerHub site URL in the URL field, including the https (e.g.: https://abc.volunteerhub.com).
- Browse for the label template you designed in Step 3 using the Template field.
- Check the Connect box.
The monitor must be running at all times during event check-in for labels to print automatically.
Step 5. Configure the OnSite and/or Kiosk App for your label printer(s).
The device you use to check volunteers in does not have to be the device your printer is installed on or connected to. Because your label printer is connected to that PC/laptop, and that PC/laptop is connected to the internet, your Kiosk and OnSite devices (e.g., tablets) will be able to communicate with your printer via the internet connection they share with your PC/laptop.
You can have several Kiosks or OnSite devices printing to the same printer. Follow the steps below to connect your printer to those devices.
- Kiosk Implementation: If you will be using Kiosk to check volunteers into their events, log in to the Admin side of the site and navigate to Settings > Kiosk Device. Select the printer name you defined in Step 4 above from the Nametag Printer field and click Save. Check a user into an event on that Kiosk device to test the integration. If successful, a nametag should print immediately upon check-in.
- OnSite Implementation: If you will be using OnSite to check users in, open OnSite and click on the Setup tab. Then, select the printer name you defined in Step 4 above from the Nametag Printer field and click Save. Check a user into an event on that OnSite device to test the integration. If successful, a nametag should print immediately upon check-in.