Skip to main content

What are good PI tag naming conventions?

What are good PI tag naming conventions?

Well-structured tag names make your PI System easier to navigate, search, and maintain as it scales.

Common Naming Patterns

Hierarchical Pattern

Site.Area.Equipment.Measurement

Examples:

Plant1.Boiler.BLR001.Temperature.PV
Plant1.Boiler.BLR001.Pressure.PV
Plant1.Pump.PMP042.Flow.PV
Plant1.Pump.PMP042.Status.DI

Source-Based Pattern

DCSName:Controller.Block.Parameter

Examples:

DCS1:FC-101.PV
DCS1:FC-101.SP
DCS1:FC-101.OP

Key Principles

1. Be Consistent

  • Pick one convention and stick to it across the entire PI System
  • Document the convention so new team members follow it
  • Use the same delimiters everywhere (. is most common)

2. Be Descriptive

  • Include enough context to identify the tag without looking it up
  • Avoid abbreviations that aren't universally understood
  • Include the measurement type (PV, SP, OP, Status)

3. Plan for Growth

  • Use zero-padded numbers (PMP001 not PMP1) for consistent sorting
  • Leave room for new areas, equipment, or measurements
  • Consider how the name will appear in PI Vision searches

Measurement Suffixes

SuffixMeaning
.PVProcess Variable (measured value)
.SPSetpoint
.OPOutput
.DIDigital Input
.DODigital Output
.AIAnalog Input
.StatusEquipment status
.AlarmAlarm state

What to Avoid

  • Spaces — use dots or underscores instead
  • Special characters — avoid \, /, *, ?
  • Overly long names — keep under 80 characters
  • Encoding meaning in position onlyT at position 5 meaning "temperature" is fragile
  • PI point names that match AF attribute paths — keep the two namespaces distinct

Relationship to AF

With PI AF, the tag name becomes less important for end users (they navigate the AF hierarchy), but good naming still matters for:

  • Interface configuration and troubleshooting
  • InstrumentTag lookups in AF templates
  • PI SMT administration and tag searches
  • Substitution parameters: \\PIServer\%..\Element%.%Element%.PV

Want to ask a follow-up?

PiChat can help with your specific PI System use case. Ask follow-up questions, get code examples, and troubleshoot issues.

Related Questions

Dive Deeper

More Questions

How do I configure PI AF templates?How do I authenticate with PI Web API from Python?What's the difference between snapshot and archive values in PI?What's the difference between PI Vision and PI ProcessBook?How do I build effective PI Vision displays?What are PI Event Frames and how do I use them?How do I write PI AF Analytics expressions?How do I use PI DataLink in Excel?Should I use PI Web API or AF SDK for my application?How do I write data to PI Data Archive?What are the main components of PI System architecture?How do I optimize PI Data Archive performance?How do I set up the PI Interface for OPC DA?How do I use PI Connector for UFL to import file data?How do I set up PI Data Archive high availability with collectives?What are the security best practices for PI System?How do I migrate PI Data Archive to a new server?How do I connect Power BI to PI System?How do I manage units of measure in PI System?What's the best way to learn PI System?How does PI time syntax work?How do I access PI System data from Java or Linux?How do I set up PI AF notification rules?How do I use batch requests in PI Web API?How do I connect to PI AF Server using AF SDK in C#?How do I write VBA macros in PI ProcessBook?How does PI data compression work?How do I get real-time streaming updates from PI Web API?How do I troubleshoot PI AF Analysis errors?How do I write SQL queries against PI using PI OLEDB?What is PI interface buffering and how do I configure it?How do I search and query PI Event Frames?What is PI Integrator for Business Analytics?How do I fix the 'Point does not exist' error in PI System?What is the difference between PI ACE and AF Analytics?How do I manually enter data into PI Data Archive?What are AF hierarchy design best practices?What is a WebID in PI Web API and how does it work?How do I configure Kerberos authentication for PI System?Can I deploy PI System in the cloud?How do I calculate summaries (average, total, min, max) in PI?What are PI digital states and how do I use them?How do I connect PI System data to Grafana?How do I backup and restore PI Data Archive?How do I create custom symbols in PI Vision?How do I automate PI System tasks with PowerShell?What is AVEVA Connect and how does it relate to PI System?How do I check and handle data quality in PI System?How do I handle pagination in PI Web API responses?How does AVEVA PI System licensing work?How do I plan a PI System upgrade?