Primary Role: Workflow Manager (Advanced – Editor Admin)
Secondary Role: Business Administrator
Learning Focus: Reference
Where: Workflow Editor (Admin access required)
🧭 Before You Start
This page is a reference, not a how-to guide.
Use it when configuring or validating question-level tags inside workflow templates.
→ See Manage Question-Level Tags for configuration steps.
📋 Question-Level Tag Overview
🔑 Required for Reporting
Tags that must exist for data to appear correctly in reports
Tag Key | Purpose | When to Use | Constraints / Notes |
| Defines the label used for the question in reports | All reportable questions | Required for Workflow Drilldown, Power BI, and analytics |
| Labels intervention response questions | Intervention-triggering workflows | Enables intervention reporting |
General Grouping & Outcomes
Tags used to group questions across workflows for analysis
Tag Key | Purpose | When to Use | Constraints / Notes |
| Groups related questions by business purpose | Reused questions across workflows | Use consistent values |
| Describes the intended outcome (e.g., training need) | Outcome-based analysis | Optional; use intentionally |
⚠️ Hazard Analysis
Tags specific to structured hazard identification and assessment
Tag Key | Purpose | When to Use | Constraints / Notes |
| Groups hazard questions by category | Hazard workflows only | Do not use outside hazard analysis |
| Identifies hazard question type (Identify, Likelihood, Severity) | Structured hazard assessments | Use org-defined defined values only |
| Categorizes hazards by location or operational area | Location-based analysis | Keep values standardized |
| Classifies hazard severity | Severity-based analysis | Align with org standards |
🛑 Interventions & Follow-Up
Tags used when workflows trigger actions or escalations
Tag Key | Purpose | When to Use | Constraints / Notes |
| Labels intervention response questions | Intervention-triggering workflows | Enables intervention reporting |
| Sub-classifies intervention types | Detailed intervention analysis | Optional |
Strength Score
Tags used only when Strength Score is enabled.
Category | Tag Key | Purpose | When to Use | Constraints / Notes |
Strength Score |
| Marks required text questions for Strength Score | Strength Score–enabled workflows | Use value |
🔢 Custom Scoring
Tags used for point-based scoring
Tag Key | Purpose | When to Use | Constraints / Notes |
| Defines maximum possible score for a question | Custom-scored workflows | Numeric responses only |
Common Tag Examples
Standard reporting question
[{"reportName":"Hazard Type"}]Custom scored question
[{"reportName":"Housekeeping"},{"maxScore":"10"}]⚠️ Usage Rules (Do Not Skip)
Do not create new tag keys without working with your Benchmark Gensuite team
Do not apply scoring tags to unsupported question types
Do not mix scoring and non-scoring intent
Do not change tags on active workflows without testing
Consistency across workflows is more important than precision
🔍 Impact on Reporting & Scoring
Question-level tags determine:
Column labels in reports
Cross-workflow comparison capability
Which questions contribute to scores
Data availability in BI tools and APIs
Incorrect tagging can affect historical and future data.