Adding tags to Blecon Track
Before a tag appears on the map, it needs to be added to your workspace. There are four ways to do this; pick the one that fits your workflow.
| Method | Best for |
|---|---|
| Web app | Adding tags one at a time during setup or testing |
| Bulk import | A spreadsheet of tag IDs, such as a list from your supplier |
| Scan workflows | Third parties (suppliers, staff) registering tags without a Blecon account |
| API | Integration with your own systems |
Web app
The quickest way to add a tag is directly from your workspace.
- Click Scan Asset in the workspace sidebar.
- If you're on a desktop, a QR code appears; scan it with your phone to open the scanner.
- Point your phone's camera at the QR code or barcode printed on the tag. Tags with an NFC chip can be read by holding the phone against the tag instead.
- The tag is added to your workspace and will appear on the live map as soon as a hotspot detects it.
You can add a name, type, and tags during or after registration from the asset detail page.
Scan workflows
Scan workflows let you delegate tag registration to suppliers, warehouse staff, or any third party, without giving them a Blecon account.
You create a scan workflow in Blecon Track with Register an asset as its action, and share it as a URL or QR code. The recipient opens it on their phone and scans each tag's QR code or barcode. Every tag they register lands in your workspace immediately, with any tags, type, and name prefix you configured on the workflow.
This is the right option when:
- Tags are being registered at a supplier's facility before shipping
- Goods-in staff need to register tags on arrival without IT involvement
- You're deploying across multiple sites with different teams
See Scan workflows for setup instructions.
Bulk import
If you already have a list of tag IDs, import them from a CSV. Go to Assets and click Import.
Your column headings are matched automatically, and you see a preview of what will be created before anything is added. Everything an import creates is labelled with the import's ID, so you can find it again or remove it in one go.
The same works for coordinate zones, from a list of site addresses.
API
For programmatic workflows, use the API.
If you know the tag IDs upfront, create assets directly:
POST /tracker/api/workspaces/{workspace_id}/assets
Include the tag ID, name, type, and any tags or metadata in the request body. See the API reference for the full schema.
If you want to use the Blecon Agent scanner in your own app, create a scan session:
POST /tracker/api/workspaces/{workspace_id}/scan-sessions
This returns a session token and scanner URL. Open the URL on a phone to start scanning; tags are registered to your workspace as they're scanned. You can embed this flow in your own application using the scanner callback mechanism.
See the API reference and API keys for authentication.