Getting started

Pair your computer

Pairing authorises a specific workstation to receive print jobs from your BadgeBadger account. Pair once per computer; it persists across browser sessions, OS user switches, and incognito.

The one-click way (recommended)

  1. Open the Print Agent (system tray icon or Applications).
  2. Click Pair this computer ↗. Your default browser opens to BadgeBadger pre-filled with the agent’s token and this workstation’s hostname.
  3. If you’re not signed in, sign in. The pairing URL waits.
  4. Confirm the “Pair this computer?” dialog. You’ll be redirected to Settings → Print agentsand see a green “This computer” chip.

The legacy way (if your browser is on a different machine)

Some setups use one PC for the printer and a different one for BadgeBadger. In that case the deep link can’t reach the right browser, so paste the token by hand:

  1. In the agent, expand Use a different browser / manual paste and click Reveal → Copy.
  2. On the browser machine, open Settings → Print agents → Pair workstation and paste the token. Save.

Durable pairing

Pairing is stored server-side (in your organisation’s agent_devices record). Once a computer is paired, every browser session for any member of your organisation can use that printer without re-pasting. Incognito sessions, new browsers, a different shift worker logging into Windows — all work.

Revoke any time. Settings → Print agents → Paired computers → Revoke on the row you want to disconnect. The agent on that machine keeps running locally but stops being reachable from the cloud.

What gets stored

  • The hostname and platform the agent reports (e.g., “Front Desk PC · Windows”).
  • A 256-bit bearer token used to authorise print jobs.
  • The list of printers the agent sees, refreshed roughly once a minute.

Nothing else — no employee data, no print previews, no usage analytics.