Pairing a beacon¶
Pairing is a single flow that scans for nearby beacons, lets you pick one, calibrates it, and saves it to your venue. The screen is called Pair New Beacons.
![]()
Before you start¶
- Make sure your device's Bluetooth is on.
- Grant beacbeac the Bluetooth and location permissions it asks for. These are required by iOS and Android for beacon scanning.
- Have the physical beacon powered on and within a couple of metres.
- Use the mobile app — pairing doesn't work in the web admin.
Pairing steps¶
- From the Admin Dashboard, open Manage Beacons.
- Tap + Add New Beacon.
- Start a scan: tap the radar icon at the top right of the screen (Start Scanning; it becomes Stop Scanning while it runs). beacbeac lists the beacons it can hear, each with its signal strength.
- Find the beacon you want and tap Pair on it. If the scan couldn't see which beacon it is (on an iPhone or iPad that's every beacon), beacbeac first connects to it and reads it (Identifying Beacon), which takes a few seconds. Keep the phone close to the beacon while it does.
- In the window that opens, give it a Beacon Name you'll recognise (e.g. the room, trail marker, or story it's next to). Major and Minor are suggested for you. Tap Configure & Pair.
- beacbeac will then run the calibration step (Calibrate Signal) — see Calibration. Tap Measure (3 seconds), then Use this value to record the result as the beacon's measured power. Skip pairs the beacon without calibrating it, using a default value. You can calibrate later by withdrawing and re-pairing it.
- beacbeac writes the settings to the beacon and saves it to your venue. There is no separate Save step. If the beacon can't be written (usually because it's too far away), beacbeac says so and saves nothing: hold the phone close to the beacon and pair it again.
- To link the beacon to a story, open it from Manage Beacons, tap Edit, and use the Associate with Stories section — see Multi-story beacons. A beacon with no story does nothing for visitors.
The beacon now appears in your beacon list. Once it's linked to a story, visitors who approach it (and have the visitor app open) will see that story.
What the scan list shows¶
Each beacon in the scan list shows one of these:
- Pair — a new beacon, not yet in your venue.
- Paired — already in service in your venue. There's no button; it can't be paired a second time.
- Withdrawn: <name> with Re-pair — a unit that is one of your venue's withdrawn beacons, named as it is in beacbeac. Re-pair keeps its Major/Minor, story links and Detection range, takes a fresh calibration, and returns it to service. The name is filled in for you and you can change it. If the beacon had been switched off from broadcasting, re-pairing turns broadcasting back on. See Calibration.
On an iPhone or iPad, the scan can't see which beacon a unit is, so at first every unit shows Pair. Tapping Pair reads the beacon before anything is changed:
- If it's a beacon already in service, beacbeac says which one (This beacon is already in your venue as <name>), pairs nothing, and the unit then shows Paired.
- If it's one of your withdrawn beacons, you go straight to Re-pair for it, and the unit then shows Withdrawn: <name>.
- If it's none of your beacons, you pair it as new.
- If your venue's beacon list can't be checked (no connection), beacbeac says so straight away, before connecting to the beacon, and pairs nothing. If the beacon can't be read (usually because it's too far away), beacbeac says so and pairs nothing too. Hold the phone close to the beacon, check your connection, and tap Pair again.
On Android the scan usually sees which beacon a unit is straight away, so Paired and Withdrawn show up without a tap. Either way, beacbeac doesn't give new numbers to a beacon that's already on your Manage Beacons list. A few older beacon records can't be re-paired: beacbeac says the beacon is already in your venue and pairs nothing. If one of those is withdrawn, return it to service from Manage Beacons instead.
A withdrawn beacon's Major/Minor can't be given to a different unit while it is withdrawn, because the withdrawn beacon can still be returned. If you type those numbers for another unit, beacbeac refuses and tells you which beacon has them.
Next step: confirm your calibration is right — see Calibration.