Beacon signal troubleshooting¶
Common beacon problems and how to fix them.
The beacon doesn't show up when I try to pair¶
- Bluetooth off. Check your phone's Bluetooth is on.
- Permissions denied. On iOS and Android, beacbeac needs Bluetooth and location permissions. Open your device's settings, find beacbeac, and enable them.
- Beacon has no battery. Most beacons have a small replaceable battery or are USB-powered. Check the power source.
- Too far away. Get within a couple of metres of the beacon.
- Already paired to another venue. A beacon can only belong to one venue at a time. Unpair it from the other venue first.
The wrong story appears¶
Another beacon is probably triggering before the intended one. Either:
- Set the affected beacon's Detection range to Touch or Close so it only triggers at close range.
- Recalibrate the affected beacons so their trigger distances don't overlap.
- Move one of the beacons further away.
- Turn one beacon's power level down (if the hardware supports it).
The story appears too early / too late¶
- Adjust the beacon's Detection range (Touch/Close/Room/Wide) — see Calibration.
- Recalibrate — see Calibration. Signal strength changes if you move the beacon, change how it's mounted, or add glass/metal near it.
No story appears at all¶
- Confirm the beacon is powered.
- Confirm the visitor app has Bluetooth and location permissions.
- In the admin app, check the beacon is linked to a story. Unlinked beacons do nothing.
- Check that neither the beacon nor its story has been withdrawn. Visitors don't see either one. A withdrawn beacon shows Withdrawn on Manage Beacons (see Withdrawing a beacon), and a withdrawn story shows Withdrawn on Manage Content (see Withdrawing, returning and deleting a story).
Rewriting a beacon's settings¶
If a beacon is broadcasting the wrong identity — for example after a factory reset, or when reusing a beacon that used to belong to a different story — open it on the beacon edit screen and use Sync to Hardware (in the Troubleshooting section at the bottom — everyday setting changes like name, status, and detection range never need it; Save Changes applies those fully on its own). To sync a beacon:
- Hold the beacon against the phone (30 cm away at most) and keep it there.
- Tap Sync to Hardware. beacbeac scans for a few seconds and takes the beacon with the clearly strongest signal, which is the one you're holding. On Android, a beacon that is already broadcasting this beacon's identity is written straight away.
- beacbeac reads that beacon before writing anything to it:
- If it already is this beacon, beacbeac writes the settings with no further question.
- If it has no identity yet, or one that isn't any of your beacons, beacbeac asks Write to this unit? and shows how strong the picked unit's signal was. Tap Sync to Hardware to write it, or Not this unit? Choose another if it isn't the beacon in your hand.
- If it's another of your beacons (a withdrawn one counts), or it can't be read, beacbeac says so and writes nothing.
- If beacbeac picked the wrong unit, tap Not this unit? Choose another on the question or the message, and pick the unit from the list of what the scan found; the unit you turned down is at the bottom. The list also opens on its own whenever beacbeac can't be sure which beacon you're holding, for example when two nearby beacons are about as strong as each other, or none is close enough to the phone. Pick the strongest entry; beacbeac still reads it before writing.
In beacbeac 1.28.0 and earlier, Sync to Hardware always shows the list on an iPhone or iPad, and you pick the strongest entry yourself.
Web platform note
The web version of beacbeac can't see Bluetooth signals at all. Use the iOS or Android app for any beacon troubleshooting.