Skip to main content

General

Designing the UNS

Best practices for structuring your Unified Namespace using ISA-95.

The Unified Namespace (UNS) is the single source of truth for the current state of your business. Structuring it correctly is critical.

ISA-95 Hierarchy

We recommend the standard 5-level hierarchy:

  1. Enterprise: Your Company Name.
  2. Site: Physical location (e.g., Istanbul_Factory).
  3. Area: Logical grouping (e.g., Production, Utilities).
  4. Line: Specific production line (e.g., Line_01).
  5. Work Cell / Asset: The machine itself (e.g., Filler, Packer).

Topic Example: AcmeCorp/Istanbul/Production/Line01/Filler/Temperature

Topic Design Tips

lightbulb
Keep it Shallow

Avoid creating hierarchies deeper than 6-7 levels. It makes wildcard subscriptions (#) harder to manage.

warning
Don't include values in topics

Bad: Line01/Temperature/45.5 Good: Line01/Temperature with payload 45.5