Scheduled Macro Adjustments (AI Macros) is an automation feature that periodically reviews each client's progress and automatically updates their nutrition targets using AI. Instead of manually recalculating macros every week, the system does it for you — analyzing compliance, weight trends, and goals to keep clients on track.
Availability
AI Macros is available on the Starter and Business plans. Not available on the Essential plan.
How to Enable AI Macros for a Client
You enable AI Macros on a per-client basis from the AI Assistant settings.
Find the client in the Client Configuration table
Toggle the AI Macros switch to ON for that client
A settings modal will appear where you configure the schedule
Schedule Settings
When you enable AI Macros, you configure the following options:
Adjustment Frequency
Weekly — adjusts macros once per week
Bi-weekly — adjusts macros every 2 weeks
Monthly — adjusts macros approximately every 4 weeks
Adjustment Day
Choose which day of the week the adjustment runs (Monday through Sunday).
Adjustment Time
Choose the time of day (in your local timezone) for the adjustment to run. The system checks once per hour, so adjustments fire at the top of the hour matching your selected time.
Client Notification
You can choose whether the client receives a message when their macros are updated. Notifications are sent via the client's preferred messaging channel (Trainerize or Telegram). You can also write a custom notification message, or leave it blank to use the default message that includes the new macro targets and the AI's explanation.
Click Save Settings to activate the schedule.
What Happens on Each Adjustment
When a scheduled adjustment fires, the system goes through these steps:
Gathers client data — current weight, age, gender, height, goal, goal weight, and starting body weight
Pulls compliance history — up to 8 weeks of weekly compliance data including average calories, protein, carbs, fat, weight, and workout/nutrition/habits compliance percentages
Calculates BMR and TDEE — uses the Mifflin-St Jeor equation with the client's current stats
Calls the AI — sends all this context to the AI nutrition engine (the same one used for manual AI suggestions), which factors in your coaching configuration, macro preferences, and the client's progress trends
Checks for significant change — the system only applies new targets if there is a meaningful difference: at least 50 calories or 5 grams in any macro (protein, carbs, or fat). If the AI suggests values very close to the current targets, the adjustment is skipped to avoid unnecessary changes
Pushes to Trainerize — if the change is significant, the new targets are pushed directly to the client's Trainerize account
Sends notification — if notifications are enabled, the client receives a message with their new targets and the AI's reasoning
Logs everything — the adjustment is recorded in the history with previous values, new values, the AI explanation, and the client's metrics at the time
What Data the AI Uses
The AI receives a comprehensive snapshot of the client when generating new targets:
Current weight — pulled from the most recent weigh-in in Trainerize
Goal and goal weight — the client's objective (e.g., weight loss, muscle gain) and target weight
Starting body weight and body fat percentage — to measure overall progress
Age, gender, and height — for accurate BMR/TDEE calculations
Weekly compliance history (up to 8 weeks) — average calories, macros, weight, and workout/nutrition/habits compliance percentages for each week
Your coaching configuration — your preferred macro preferences, coaching philosophy, and any custom prompt instructions you have set
Unit system — respects your business's unit preference (metric or imperial)
Adjustment History
Every scheduled adjustment is logged regardless of outcome. Each history entry includes:
Previous targets — calories, protein, carbs, and fat before the adjustment
New targets — the AI-suggested values
Status — whether the adjustment was applied, skipped (no significant change), or failed (error occurred)
AI explanation — the reasoning behind the suggested changes
Metrics snapshot — the client's weight and compliance data at the time of the adjustment
Notification status — whether a notification was sent and through which channel
Scheduled macro adjustments also appear on the client's Unified Calendar so you can see when the next adjustment is due.
Troubleshooting
Macros are not adjusting on schedule
Make sure the AI Macros toggle is ON for the client in AI Assistant > Settings > Client Configuration
Confirm the schedule settings (day, time, frequency) are correct
The system processes adjustments once per hour. Adjustments fire at the top of the hour when the current hour in your configured timezone matches the adjustment time
If an adjustment was overdue (e.g., the system missed a day), it will be silently rescheduled to the next correct weekday rather than firing on the wrong day
Adjustment was skipped
This means the AI suggested values very close to the current targets. The system requires at least a 50-calorie or 5-gram difference to apply changes. This prevents unnecessary micro-adjustments
Adjustment failed
Check that the client has an active Trainerize account linked
The client needs enough data for the AI to work with — recent weigh-ins and some compliance history help produce accurate suggestions
Failed adjustments are automatically rescheduled so they do not get stuck
Client did not receive a notification
Verify that Send notification is checked in the AI Macro settings for that client
The client must have a messaging channel configured (Trainerize thread or Telegram group)
If the adjustment was skipped (no significant change), no notification is sent
Duplicate protection
The system has built-in duplicate protection. If an adjustment was already applied within the current cycle window (7 days for weekly, 14 days for bi-weekly, 28 days for monthly), it will not run again. The schedule will simply advance to the next date.
Disabling AI Macros
To stop scheduled adjustments for a client, toggle the AI Macros switch to OFF in the AI Assistant > Settings > Client Configuration page. This immediately disables the schedule. You can re-enable it at any time and reconfigure the settings.