FAQ: Understanding "Needs Attention" Logic

Frequently Asked Questions About "Needs Attention"

Q: Why do I see different "Needs Attention" counts in different places?

A: You shouldn't! Both the Dashboard Overview card and the Client Engagement dashboard use the exact same calculation: Engagement Status = "Poor". If you see different numbers, this is a bug - please report it immediately. The counts should always match to ensure consistency and build trust in the insights.

Q: How is "Needs Attention" calculated?

A: "Needs Attention" is determined by Engagement Status = "Poor". A client receives "Poor" status when they have both low adherence (<40% of scheduled workouts completed) AND low Build Score (<40 out of 100). This standardized calculation ensures consistency across all dashboards and helps you focus on clients who are truly at risk of churning.

Q: What exactly triggers the "Needs Attention" flag?

A: A client needs attention when their Engagement Status is "Poor". This is calculated automatically based on their adherence to their training plan and their Build Score. A client receives "Poor" status when: • They have scheduled workouts this week AND completed <40% of them (adherence <40%) AND their Build Score is <40, OR • They have no scheduled workouts this week AND their Build Score is <40, OR • They have scheduled workouts but completed <40% AND their Build Score is <40

This standardized calculation ensures consistency across all dashboards and helps you focus on clients who are truly at risk of churning - those with both low adherence AND low Build Scores.

Q: Why is this important to track?

A: Research shows that a 5% increase in client retention can boost profits by 25-95%. Clients who go 7+ days without activity are at high risk of canceling. By tracking and acting on "Needs Attention" flags, you can: • Prevent churn - Reach out before clients become inactive • Improve retention - Proactive check-ins dramatically improve retention rates • Save time - Focus on clients who truly need attention, not guessing • Build trust - Consistent data across all dashboards builds confidence in the insights

Q: How quickly should I reach out to clients who need attention?

A: Within 24-48 hours. Quick response shows you care and prevents further disengagement. The longer you wait, the higher the risk of the client canceling.

Q: What should I say when reaching out?

A: Ask open-ended questions to understand obstacles: • "How are you feeling about your training plan?" • "What obstacles are you facing?" • "Is there anything I can help adjust?"

Then offer solutions: • Adjust workout frequency if time is an issue • Modify exercises if there are physical concerns • Provide additional support or motivation

Q: Why does a client with a Build Score of 48 need attention but one with 52 doesn't?

A: The threshold of 50 is based on research showing that clients with scores below 50 are at significantly higher risk of churning. However, if a client with a score of 52 has other warning signs (like missing scheduled workouts or no activity in 7+ days), they may still need attention. The system considers multiple factors, not just the score alone.

Q: What if a client has no Build Score yet (shows "--")?

A: Clients without scores are evaluated based on activity patterns. If they have scheduled workouts but completed none this week, or if their last workout was more than 7 days ago (or never), they'll be flagged as needing attention. This ensures new clients who aren't engaging are caught early.

Q: Can I trust that the numbers are accurate?

A: Yes! Both the Dashboard Overview and Client Engagement dashboard use the exact same calculation: Engagement Status = "Poor". This is calculated by the same PostgreSQL database function (`get_trainer_clients_progress`) across all views. This ensures: • Consistent logic across all views - the same client will show the same status everywhere • Accurate calculations based on real-time data from your database • No discrepancies between different parts of the platform • Trustworthy insights you can act on with confidence • Single source of truth - one calculation, one result, everywhere

Q: How often is "Needs Attention" recalculated?

A: The calculation happens in real-time whenever you view the dashboard. It's based on the most current data in your database, so you're always seeing up-to-date information.

Q: Should I focus on all clients who need attention equally?

A: No - prioritize based on risk level: 1. Highest Priority - Clients with Build Score < 30 (very low engagement) OR no activity in 14+ days 2. High Priority - Clients with Build Score < 50 AND no workouts this week 3. Medium Priority - Clients who missed scheduled workouts but have recent activity 4. Lower Priority - Clients with scores 40-49 who are still somewhat active

Q: What's the business impact of tracking "Needs Attention"?

A: Significant! Studies show: • 25-95% profit increase from just a 5% improvement in retention • Proactive outreach reduces churn by catching disengagement early • Data-driven coaching helps you focus time on clients who truly need help • Consistent metrics build trainer confidence and improve decision-making

Key Takeaway:

The "Needs Attention" feature is your early warning system. By tracking clients with "Poor" engagement status and reaching out proactively, you can prevent churn, improve retention, and grow your business. The consistent calculation (Engagement Status = "Poor") across all dashboards ensures you can trust the numbers and take action with confidence.

Related Resources:

• How Engagement Scores Work - Detailed explanation of the calculation • Client Churn Prevention Guide - How to identify and prevent churn • The Business Case for Client Retention - Financial impact of retention