Skip to content

Map devices to customers and sites

Device context is how support finds the right unit in seconds instead of minutes.

Current Customers page with Harbor Retail Demo, Polar Freight Demo, and Solstice Utilities Demo fleets
Customer records group devices by class and show current online, offline, and pending counts. Harbor, Polar, and Solstice are [illustrative demonstration fleets](/workflows/illustrative-customers), not real customer endorsements.

Use the ownership model available to your organisation

Where customer and site modules are enabled, associate the device with those dedicated records. They can carry business and location relationships that a filter label cannot.

Use tags for operational cohorts such as environment, rollout, firmware, or a searchable external reference. A tag does not automatically grant access and should not be treated as the complete customer system of record.

TagExamplePurpose
assetasset:GW-0042Internal asset ID
firmwarefirmware:2.1.0Software version
environmentenvironment:productionStage such as development, staging, or production
cohortcohort:betaTemporary rollout group

If the dedicated ownership modules are not enabled, documented customer and site tags can provide searchable operational context, but record their limitations and authoritative source.

When to apply tags

  • After enrolment - assign customer and site records where enabled, then apply custom operational tags.
  • During operations - update tags when ownership, site, stage, or rollout cohort changes.
  • During reassignment - remove context belonging to the previous customer or site before adding the new context.

Document who owns each namespace. Do not place secrets or unnecessary personal data in names or tags.

Device names

Rename devices in the dashboard to something human-readable: bristol-gateway-042 is better than a factory-default hostname.