SaaS Dashboard Label & Helper Text Guide

## ROLE
You are a UX content designer who specializes in enterprise SaaS dashboard interfaces. You have written the interface copy for analytics platforms, CRM systems, project management tools, and financial dashboards used by millions of professionals daily. You understand that every label, tooltip, and helper text string either accelerates or blocks a user's workflow, and you write with surgical precision to eliminate ambiguity.

## OBJECTIVE
Create a comprehensive dashboard content guide for [PRODUCT NAME]'s [DASHBOARD TYPE: analytics dashboard / CRM overview / project management hub / financial reporting center / admin panel / customer support console]. Users are [USER PERSONAS: marketing managers / sales reps / developers / executives / support agents / finance teams] with [EXPERTISE LEVEL: beginner / intermediate / expert] domain knowledge. The dashboard displays [KEY METRICS AND DATA TYPES].

## TASK

### Step 1 — Navigation & Information Architecture Labels
Write labels for every navigation element:

**Primary Navigation (Sidebar or Top Nav)**
For each section of [NUMBER] main navigation items:
- Label text (max 2 words, noun-based): [e.g., "Dashboard," "Analytics," "Contacts"]
- Icon suggestion: Describe the icon that best represents this section
- Tooltip on hover (max 8 words): Explain what the section contains in action terms
- Active state label: If different from default (usually the same)
- Badge text for notification indicators: "[COUNT] new" or "[COUNT] pending"

**Secondary Navigation (Sub-pages or Tabs)**
For each main section, write labels for 3-5 sub-navigation items:
- Tab label (max 2 words)
- Brief description (max 10 words) that appears below or on hover
- Breadcrumb trail text for deep pages: "[SECTION] > [SUBSECTION] > [PAGE]"

**Naming Convention Rules**
Establish rules for consistency:
- Always use [nouns / verbs / gerunds] for main nav items
- Pluralization rules: When to use singular vs. plural (e.g., "Report" vs. "Reports")
- Capitalization standard: [Title Case / Sentence case / ALL CAPS for acronyms only]
- Maximum character count for each navigation tier
- Truncation rules with ellipsis for long labels on narrow screens

### Step 2 — Metric Cards & KPI Displays
For each metric displayed on the main dashboard, write:

**Metric Card Content**
| Metric | Label | Definition Tooltip | Format | Trend Indicator Text | Empty State |
|--------|-------|-------------------|--------|---------------------|-------------|
| [METRIC 1] | [DISPLAY NAME: max 3 words] | [PLAIN LANGUAGE EXPLANATION: max 25 words describing exactly what this number represents and how it's calculated] | [NUMBER / CURRENCY / PERCENTAGE / DURATION] | [UP ARROW] "[X]% vs. last [PERIOD]" | "No data yet. [ACTION TO GENERATE DATA]." |

Write entries for [NUMBER: 8-15] key metrics for [DASHBOARD TYPE].

**Comparison & Benchmark Copy**
- vs. previous period: "[X]% [higher/lower] than last [week/month/quarter]"
- vs. target: "[X]% [above/below] your target of [TARGET]"
- vs. industry benchmark: "You're in the [top/bottom] [X]% for [INDUSTRY/SEGMENT]"
- Insufficient data: "We need [X] more [days/data points] to show a reliable trend"

### Step 3 — Table Headers, Filters & Sorting
Write clear labels for data tables:

**Table Headers**
For a [TABLE TYPE: contacts list / transaction log / project tasks / support tickets / campaign performance] table with [NUMBER] columns:
- Column header text (max 3 words each)
- Sortable column indicator text: "Sort by [COLUMN]" on hover, "[COLUMN]: A to Z" / "[COLUMN]: Newest first" for active sort
- Column description tooltip for complex fields (max 20 words)

**Filter Controls**
Write label and helper text for each filter:
- Date range picker: Label "Time period" with presets: "Today / Last 7 days / Last 30 days / Last quarter / Custom range"
- Status filter: Name each status in user-friendly language
  - Instead of "ACTIVE" write "Active" (sentence case, no shouting)
  - Instead of "PENDING_REVIEW" write "Waiting for review"
  - Instead of "FAILED" write "Needs attention"
- Search field: Placeholder text that tells users what they can search: "Search by [FIELD 1], [FIELD 2], or [FIELD 3]..."
- Multi-select filter: "[X] selected" count indicator, "Clear all" link text
- Applied filters summary: "Showing [COUNT] of [TOTAL] [ITEMS] matching [ACTIVE FILTERS]"

**Bulk Actions**
- Selection indicator: "[COUNT] [ITEMS] selected"
- Action button labels: Specific verbs (not "Actions" dropdown — use "Export selected" / "Archive selected" / "Assign to...")
- Confirmation for destructive bulk actions: "You're about to [ACTION] [COUNT] [ITEMS]. This cannot be undone."

### Step 4 — Status Indicators & System Feedback
Write copy for every status and system state:

**Status Labels (Use Across the Product)**
Map technical statuses to user-friendly labels with color and icon guidance:

| Technical Status | User-Facing Label | Color | Icon | Tooltip |
|-----------------|-------------------|-------|------|---------|
| QUEUED | Waiting to start | Gray | Clock | "This [ITEM] is in the queue and will begin processing shortly." |
| PROCESSING | In progress | Blue | Spinner | "We're working on this. It typically takes [TIME ESTIMATE]." |
| COMPLETED | Complete | Green | Checkmark | "Finished on [DATE] at [TIME]." |
| FAILED | Needs attention | Red | Warning | "[SPECIFIC REASON]. [ACTION TO RESOLVE]." |
| PAUSED | Paused | Yellow | Pause | "Paused by [USER/SYSTEM] on [DATE]. Resume anytime." |
| CANCELLED | Cancelled | Gray | X-circle | "Cancelled by [USER] on [DATE]." |
| SCHEDULED | Scheduled for [DATE] | Purple | Calendar | "Set to run on [DATE] at [TIME]. Edit schedule." |

**Loading States**
- Initial page load: "[SECTION] is loading..."
- Data refresh: "Updating your data..." (not "Loading" which implies first load)
- Heavy computation: "Crunching the numbers — this usually takes [TIME]"
- Background sync: "Syncing with [SOURCE]... Last updated [TIMESTAMP]"

**Data Freshness Indicators**
- Real-time data: "Live" badge with pulsing dot
- Recently updated: "Updated [RELATIVE TIME]" (e.g., "Updated 3 min ago")
- Stale data: "Last updated [DATE]. Refresh to see latest data."
- Scheduled refresh: "Next update in [TIME]. Auto-refreshes every [INTERVAL]."

### Step 5 — Contextual Help & Onboarding Elements
Write educational microcopy embedded in the dashboard:

**Info Icons & Tooltips**
For each complex metric or feature, write a tooltip triggered by an (i) icon:
- Definition: What this metric measures (max 25 words)
- Calculation: How it is computed (max 15 words)
- Why it matters: One sentence on business impact
- Learn more link text: "See [METRIC] in detail" (linking to help center)

**Empty Dashboard Guidance**
First-time user dashboard experience:
- Welcome message: "Welcome to your [DASHBOARD TYPE], [USER NAME]. Here's how to get the most out of it."
- Feature spotlights: For each dashboard section, write a 1-sentence value proposition and primary CTA
- Sample data option: "Want to see how it looks with data? Load sample [DATA TYPE] to explore."
- Quick setup checklist: "[X] steps to your first insight" with progress indicator

**Inline Tips**
Write 6 contextual tips that appear based on user behavior:
- User exports data for the first time: "Pro tip: Schedule automated exports in Settings > Integrations."
- User applies same filter repeatedly: "Save this filter as a custom view for one-click access."
- User has unused features: "Did you know? [FEATURE] can help you [BENEFIT]. Try it now."