AI Check-Ins allow you to create fully personalized, data-driven weekly messages using placeholders. This guide explains every available placeholder and how to use them effectively.
What Are Placeholders?
Placeholders are special codes that automatically get replaced with real client data when an AI Check-In is sent.
They look like this:
######{{avg_calories_eaten}} ######{{client_first_name}} ######{{workouts_completed}}Example:
Hey ######{{client_first_name}}, great work completing ######{{workouts_completed}} workouts!becomes:
Hey Sarah, great work completing 5 workouts!
This allows you to write one template that dynamically customizes itself for every client.
Data Timeframe (Important)
Most placeholders automatically follow the Data Timeframe you select in your template:
This Week — Monday to yesterday (excludes today)
Last Week — previous full Monday to Sunday
This Month — 1st of the month to yesterday
Last Month — 1st to last day of the previous month
This ensures all data inside your check-in refers to the same period. For a detailed explanation, see the article How Data Timeframe Works in AI Check-Ins.
All Available Placeholders
Below is the full categorized list.
AI-Generated Content
These generate custom AI feedback using all available client data.
Placeholder | Description |
| Full personalized AI coaching feedback based on workouts, nutrition, habits, weight, sleep, WHOOP, Oura, and more. |
Custom AI Templates:
You can create your own prompts inside AI Check-Ins → AI Prompts.
After saving, they become placeholders like:
######{{motivational_coach}} ######{{nutrition_focus}} ######{{strength_analysis}}Client Information
Placeholder | Description |
| First name |
| Last name |
| Full name |
| |
| Phone |
| City |
| Age |
| Date of birth |
| Gender |
| Fitness goal |
| Target goal weight |
| Program start date |
| When they joined |
| Last login date |
| Assigned coach name |
| Client type (lead, client, trial, etc.) |
| Active, inactive, etc. |
| All tags |
| Height |
| Activity level |
| Max heart rate |
| Starting weight |
| Starting body fat % |
| Basal Metabolic Rate (BMR) |
| Body Mass Index (BMI) |
Weekly Information
Placeholder | Description |
| Week start date |
| Week end date |
| Week number of the year |
Weight & Body Composition
Placeholder | Description |
| Average weight (uses selected Data Timeframe) |
| Average weight this week |
| Average weight last week |
| Average weight 2 weeks ago |
| Weight change from last week to this week |
| Weight change between prior two weeks |
| Total weight change since starting |
| Average body fat % (uses selected Data Timeframe) |
| Average body fat this week |
| Average lean mass (uses selected Data Timeframe) |
| Average lean mass this week |
| Average fat mass (uses selected Data Timeframe) |
| Average fat mass this week |
| Average BMI this week |
Nutrition Data
Averages:
Placeholder | Description |
| Target daily calories |
| Average daily calories eaten |
| Average daily calories burned |
| Daily calorie deficit/surplus |
| Protein goal (g) |
| Protein eaten (g) |
| Carb goal (g) |
| Carbs eaten (g) |
| Fat goal (g) |
| Fat eaten (g) |
| Average fiber (g) |
| Average sodium (mg) |
| Average sugar (g) |
| Average daily water intake (displayed in ml or fl oz based on unit settings) |
| Average daily water goal (displayed in ml or fl oz based on unit settings) |
| Compliant days (calories within tolerance % of goal) |
| Days with nutrition logged (calories > 1) |
| Nutrition logging compliance (%) |
Totals & remaining:
Placeholder | Description |
| Total calorie goal for selected timeframe |
| Total protein goal (g) |
| Total carbs goal (g) |
| Total fat goal (g) |
| Total sum of all calories eaten |
| Remaining calories to reach goal |
| Remaining protein (g) |
| Remaining carbs (g) |
| Remaining fat (g) |
| Average remaining calories needed per remaining day |
Workout Performance
Placeholder | Description |
| Completed workouts |
| Scheduled workouts |
| Workout compliance % |
| Cardio sessions completed |
| Average daily steps |
| List of all workouts with total volume (weight x reps) |
| Workout volume comparison: current vs previous period with % changes |
Habits
Placeholder | Description |
| Completed habits |
| Scheduled habits |
| Habit compliance % |
Health Metrics
Placeholder | Description |
| Average resting heart rate (bpm) |
WHOOP Recovery & Strain
These placeholders require the client to have a WHOOP device connected.
Placeholder | Description |
| Average recovery score |
| Average HRV (heart rate variability) |
| Average resting heart rate |
| Average blood oxygen (SpO2) |
| Average skin temperature |
| Average strain score |
| Average calories burned |
| Average heart rate |
| Average max heart rate |
WHOOP Sleep Data
Placeholder | Description |
| Average sleep hours |
| Average deep sleep % |
| Average REM sleep % |
| Average sleep performance score |
| Average sleep consistency score |
| Average sleep efficiency % |
| Average respiratory rate |
Oura Ring Data
These placeholders require the client to have an Oura Ring connected.
Readiness & Heart Rate:
Placeholder | Description |
| Average readiness score |
| Average temperature deviation |
| Average resting heart rate |
| Average heart rate |
| Average HRV (heart rate variability) |
Activity:
Placeholder | Description |
| Average activity score |
| Average daily steps |
| Average active calories |
| Average total calories |
Sleep:
Placeholder | Description |
| Average sleep score |
| Average sleep hours |
| Average deep sleep % |
| Average REM sleep % |
| Average light sleep % |
| Average sleep efficiency % |
| Average time to fall asleep (minutes) |
| Average awake time (minutes) |
Recent Conversations
Placeholder | Description |
| Last 5 messages from client conversations (provides context and continuity for AI feedback) |
Form Submissions
Placeholder | Description |
| Name of the submitted form |
| When the form was submitted |
| All questions and answers from the form submission |
Each published form also generates its own unique placeholder for a personalized form link. These appear automatically in the placeholder toolbar under the Forms category.
Pro Tips
Start simple. Use
######{{client_first_name}}, a few nutrition/workout placeholders, and######{{ai_coach_feedback}}for your first template. Add more as you get comfortable.Use the placeholder toolbar. When editing a template, click the placeholder dropdown to browse all available placeholders by category — no need to memorize names.
Mix AI with data. Combine specific data placeholders (e.g.,
######{{avg_calories_eaten}}) with AI feedback (######{{ai_coach_feedback}}) for templates that show both hard numbers and coaching commentary.Test before sending. Always use the Test button to preview your template with a real client's data before scheduling it for everyone.
Import proven templates. Click Import Proven Templates to get pre-built, tested templates you can use immediately or customize.
Important Note About Missing Data
If a client doesn't have data for a placeholder, FitMetrics displays [Not Available].
Placeholders like ######{{client_starting_weight}}, ######{{client_goal_weight}}, ######{{client_goal}}, and ######{{client_starting_body_fat}} must be filled in manually from Trainerize Clients by finding the corresponding columns. Anything else that shows [Not Available] means the client hasn't provided that information in Trainerize yet.
AI placeholders like ######{{ai_coach_feedback}} automatically adjust their coaching message to gracefully handle missing data — they won't break or show raw placeholder text.
