What a worker name is on a mining pool, and why each of your machines should have its own

A worker name is the label a miner sends the pool so the pool knows which machine did the work. It takes a minute to set, changes nothing about earnings and is the difference between seeing one blurry total and seeing a line for every machine you own.

A worker name is the label that tells the pool which machine sent the work

When a miner connects to a pool, it has to say who it is. The pool needs to know whose account the work belongs to, and it also needs a name for the individual machine. That second part is the worker name. ViaBTC's pool guide calls it the label that identifies a specific miner under your pool account, and says the pool uses it to connect each submitted share to the right device.

If you have not met pools yet, our guide to what a mining pool is comes first. A worker is simply one machine as the pool sees it: one line in your dashboard, with its own hashrate.

The format: your account, a dot, then a name you choose

On most pools the worker name is written as the account name, a full stop and then the label, so a machine on the account "myuser" might connect as myuser.1. AwesomeMiner's help page uses exactly that example. Braiins Pool describes its User ID as the account name plus a worker name, "any device identifier", and says the User ID is what pairs the device with your account.

Some pools do not have accounts. They ask for a wallet address in the first part instead, followed by the label. ViaBTC says the exact syntax depends on the pool and the coin, so the pool's own setup page for your coin is the reference. Our guide to wallet addresses explains what that address is for.

The password field is a separate box and normally does not matter. Braiins puts it plainly: "Password is not used, it can be anything."

Account, dot, label. The first part is yours to the pool; the second is yours to you.

One label per machine is what lets you see each machine

The label does not change how much a machine hashes. ViaBTC is explicit that it only identifies the device for tracking. What it changes is what you can see. With a separate label on every machine, the pool shows a hashrate line for each one, so you can spot the unit with low hashrate or frequent interruptions. Braiins recommends "a separate workerName for efficient monitoring".

AwesomeMiner lists the alternative: every miner reporting the same name, in which case the pool shows only the total. That works until the total drops. A total that falls by a fifth tells you something is wrong and nothing about which machine, and with several machines you are left checking them one at a time.

The per-machine line is also where the normal noise of a dashboard becomes readable. Our guides on why a miner's hashrate reads lower than its spec sheet and on rejected and stale shares show what to expect from one machine. You can only compare against that if the dashboard shows one machine at a time.

What a worker name does not do

It does not decide where the coins go. Payouts follow the account or wallet address in the first part, and that is set in the pool, not in the label. If you want to move earnings to another wallet, that is a different change, and our guide on changing the pool or payout wallet covers what happens to coins already earned.

It is also just a name. Treat it like a sticker on the machine: it exists so that you can tell one machine from another, and nothing about it protects or unlocks anything.

How to choose names you will still understand in a year

Keep it short and boring. Numbers work well: 01, 02, 03, in the order you bought the machines, or a model name and a number such as s21-01. Use letters, digits and hyphens. ViaBTC advises checking the permitted characters and length before saving, and does not list them, so a plain name avoids the problem.

Write the list down next to the serial numbers. If a machine is replaced, give the new one a new label rather than reusing the old one, so the history on the dashboard stays with the machine that earned it.

Keep private details out of the name. It is shown on dashboards, so a number is better than a note about where the machine lives or what you paid for it.

If a machine you expect is missing from the dashboard

A new machine usually appears once it has connected and submitted work. If it does not, the first thing to check is the first part of the name, because the pool pairs the machine with an account through it. A misspelt account name sends the work nowhere you are looking. Then check the label for characters the pool does not accept.

Some setups behave differently when the label is left empty. Braiins creates an "[auto]" worker, while AwesomeMiner warns that in one configuration mode a miner with no name defined will not mine at all. If a machine is hosted, ask the host for the full list of worker names and the pool account they sit under, then match it against what you see.

An example: five machines, five lines

Say the account is "myuser" and you own five identical machines, labelled s21-01 to s21-05. The pool lists them as myuser.s21-01 through myuser.s21-05, each with its own hashrate line, so each machine's contribution is there to read.

Now one afternoon the account total is a fifth lower than it was in the morning. With five equal machines, that is exactly what one machine going quiet looks like: four lines level and one at zero. You know which machine to look at, and the label even tells you which one it is on the shelf.

With the same name on all five, you would see the total fall by a fifth and have nothing else to go on. The fault is the same in both cases. What the labels change is how long it takes to find it.

If your machines are hosted, three things to ask

When a host runs the machine for you, the host usually enters the pool settings, so the names are chosen by someone else. That is fine, as long as you know what they are. Ask which pool account each machine is on, which worker name each one has, and which serial number goes with which name.

Keep that list. If a machine is ever moved or swapped, ask for the list to be updated, so the name on the dashboard still matches the box it describes.

Our guide to how hosting works covers who does what at each step. The worker list is the one record that lets you and the host talk about the same machine.

What it means for a miner

The worker name is the cheapest monitoring you will ever set up. It costs nothing, takes a minute per machine and turns one blurry total into a line for every machine you own.

When you own several machines, or one machine hosted for you, it is also how you check the numbers you are told against the numbers the pool records. A clear name on every machine means a question about one machine can be answered with that machine's line, and the coins it earns are the ones that count.

Sources and further reading

Mining Pool Worker Name Explained — ViaBTC, 20 Jul 2026
Braiins Pool quick start — Braiins Academy, 9 Nov 2026
Pool worker names — AwesomeMiner support, 9 Nov 2026

Disclosure

Firsthand Bitcoin sells and hosts mining hardware, including this machine. No manufacturer, distributor or affiliate programme paid for or reviewed this page and we take no commission on the links above. Historical figures are computed from daily bitcoin price and network hashprice, each day valued at its own prices. Nothing here is investment advice.