How do I…?

Steps

For a meal from today, yesterday, or the day before yesterday:

1. Tell Coach what you forgot to log and the day you ate it.
2. If Coach asks, reply with the time you ate it.
3. Review the date and time on the meal card, then tap Log now or Log for [time].

To move an existing meal or back-date an older meal:

1. Open the Today tab, select the relevant day, and tap the meal you want to change.
2. In the meal editor, tap the date or time control near the top of the meal details.
3. Choose when you actually ate the meal.
4. Tap Done to save the change.

Notes

Changing the time moves the meal to the appropriate place on the daily energy timeline. Meals cannot be logged at a future time because the nutrition timeline represents food already consumed.

From Today

1. Open Today and find the original meal. Select an earlier day first if needed.
2. Swipe the meal row to the right.
3. Tap Log Now.

From the meal editor

1. Tap the meal on Today.
2. Tap the … button.
3. Choose Log Again.

This creates a new meal at the current time. It does not change the original meal and does not add anything to Quick Foods.

Steps

1. Open the Log tab.
2. Choose Scan, select Food mode, and take a photo or choose one from your album.
3. Wait for MacroMotive to identify the foods and estimate portions and nutrition.
4. When analysis succeeds, the meal is logged at the current time and the app returns to Today.
5. Tap the new meal on Today if you need to review or correct it.

Notes

Photo results are estimates. Open the logged meal and correct its portions when the totals do not match what you ate.

Steps

1. Open Log and tap Manual in the upper-right corner.
2. Enter a meal name and the food item's name.
3. Enter the portion and nutrition values you know.
4. Tap Done to log the meal.

Manual entry does not require a photo or AI analysis. You can also reach it from Log → Saved → Enter macros from scratch. Use Build when you need several separately entered ingredients in one meal.

Steps

1. Open Log and choose Describe.
2. Type what you ate, including useful portion details.
3. Tap Analyze with coach.
4. When analysis succeeds, the meal is logged at the current time and the app returns to Today.
5. Tap the new meal on Today if you need to review or correct it.

This feature uses AI processing and requires consent plus available AI access. Described nutrition is an estimate; include quantities when you know them.

Steps

1. Open Log, choose Scan, and select Barcode mode.
2. Point the camera at the product barcode and hold it steady.
3. When the lookup succeeds, the product is logged at the current time and the app returns to Today.
4. Tap the new meal on Today if you need to review or correct its portion.

Alternatives

If the barcode cannot be scanned, switch to Label mode and photograph the product's Nutrition Facts panel.

Steps

1. Open Log, choose Scan, and select Label mode.
2. Fill the guide with a clear, straight-on view of the Nutrition Facts panel.
3. Take the photo or choose an existing photo from your album.
4. When analysis succeeds, the food is logged at the current time and the app returns to Today.
5. Tap the new meal on Today if you need to correct its serving or nutrition.

Label analysis uses AI processing. Printed serving information is a stronger starting point than a plate-photo estimate, but you should still confirm the amount you actually ate.

Steps

1. Open Log, choose Scan, and select Recipe mode.
2. Photograph the recipe so its ingredients, quantities, and serving information are readable.
3. When analysis succeeds, one estimated serving is logged at the current time and the app returns to Today.
4. Tap the new meal on Today if you need to adjust the serving or ingredients.

Recipe analysis uses AI processing and remains an estimate. If the recipe spans several pages or you want to assemble ingredients individually, use Build instead.

Steps

1. Open Log, choose Build, and tap Start Building.
2. Tap Add Ingredient and add each ingredient using Scan, Describe, or Manual.
3. Review the portions and nutrition as you go.
4. Tap Log Meal to create one combined entry.

Notes

If you leave before logging, choose Keep Draft and return to Build later to resume it. Choose Discard Draft only when you no longer need its ingredients.

Steps

1. Open Today and tap the logged meal you want to correct.
2. Tap a food item to expand its details.
3. Adjust its name, quantity, serving unit, or nutrition values.
4. If portions changed and a metabolic estimate is shown, tap Portions changed — recalculate to refresh it.
5. Tap Done to save the correction.

AI-assisted alternative

Tap AI Fix Issues, describe what is wrong, and review the proposed correction before finishing. AI processing consent and available AI access are required for this option.

Notes

Standard Scan and Describe flows log immediately. Open the resulting meal from Today to make these corrections.

Quick save from Today

1. Open Today and find the meal.
2. Swipe the meal row to the right.
3. Tap Save.

Other ways to save

Long-press the meal row and choose Save to Quick Foods, or open the meal, tap …, and choose Save to Quick Foods.

Saving creates a reusable template. It does not log another copy of the meal.

Steps

1. Open Log and choose Saved.
2. Search or change the sort order if needed.
3. Tap the saved food you want to log.

The food is logged immediately at the current time and the app returns to Today. To review a template without logging it, use Profile → View saved foods instead.

From the Log tab

1. Open Log → Saved.
2. Use Search or the sort button to find the template.
3. Swipe the row to the left and choose Edit or Delete.

From Profile

1. Open Profile → View saved foods.
2. Tap a row to edit its name, photo, portions, or nutrition, then tap Save Changes.
3. To remove one, swipe its row to the left and confirm Delete saved food.

Tapping a saved food under Log → Saved logs it immediately. Tapping one under Profile → View saved foods opens it for editing without logging it.

Steps

1. Open the Today tab and tap the meal you want to share.
2. Tap the … button in the upper-right corner.
3. Tap Share meal.
4. Choose Messages, Mail, AirDrop, or another destination in the iOS share sheet.

Notes

Anyone holding the link can open the shared meal. Shared meal links expire after 90 days.

Steps

1. Open the MacroMotive meal link you received.
2. If asked, choose MacroMotive to open the link.
3. Review the meal in Add shared meal and adjust its name, items, portions, or nutrition if needed.
4. Tap Done to log a copy to your own timeline.

Adding a shared meal never changes the sender's meal. If the app says it could not load the meal, the link may have expired or no longer exist.

Steps

1. Open Today and find the meal or manually logged workout in the daily log.
2. Swipe the row to the left to reveal its delete action.
3. Confirm deletion when asked.

Notes

Deleting an entry removes it from the day and recalculates the displayed totals. Workouts synced from Apple Health are read-only in MacroMotive; delete those in Apple Health instead.

Describe a meal to Siri

1. Say “Siri, log a meal in MacroMotive.”
2. When Siri asks what you ate, describe the foods and portions.
3. Listen for the logged-meal confirmation.

Log a saved food

Say “Siri, log [saved food name] in MacroMotive,” or run Log a Saved Food in the Shortcuts app.

You must already be signed in. Describing a new meal uses AI processing and requires consent plus available AI access. Logging an existing saved food does not use AI access.

The meal energy curve estimates how the meal's carbohydrate, fiber, fat, and protein mix may release energy over the following hours. Glycemic impact, digestion, satiety, and crash risk are estimates from the same model.

Use these values for planning and reflection. They are not blood-glucose measurements and are not intended for diagnosis or treatment.

The Today tab places meals and activities on one estimated energy timeline. Tap the energy card to open its detailed view, where you can zoom and inspect individual events.

The curve is a planning estimate based on logged meals and timing, not a glucose reading.

Steps

1. Open Today.
2. Use the horizontal day selector near the top to choose the date you want.
3. Tap Morning, Afternoon, or Evening to expand that part of the daily log.
4. Tap a meal to edit it, or use its swipe actions to save, repeat, or delete it.

Selecting the Today tab again returns the screen to the current day.

Consumed and remaining macros

Tap the calorie ring on Today to switch the calorie, protein, carbohydrate, and fat figures between consumed and remaining values. The progress fill continues to show what has been consumed.

Other nutrition panels

Swipe the Nutrition card horizontally, or tap its page indicators, to view fiber, sugar, and sodium on the micronutrient page and the day's caffeine total and timing on the caffeine page.

Steps

1. Open the Trends tab.
2. Choose Week for the last 7 days or Month for the last 30 days.
3. Review average calories, active time, and latest weight at the top.
4. Scroll for calorie, macro, caffeine, workout-minute, and weight charts.

The dotted line on the calorie chart is your current daily calorie target. Missing weight points mean no weigh-in was available for that day.

Start

1. Open Profile and find Live Activity.
2. Tap Track energy on Lock Screen.
3. View current estimated energy and macro progress on the Lock Screen and, on supported devices, the Dynamic Island.

Use the Live Activity's Log meal control to open the logger. To stop it, return to Profile → Live Activity and tap Stop Live Activity.

Add the widget

1. Touch and hold an empty area of the iPhone Home Screen until editing controls appear.
2. Use Add Widget and search for MacroMotive.
3. Choose the small or medium widget, add it, and finish editing the Home Screen.

The small widget shows Daily Energy and opens Today when tapped. The medium widget also shows calorie and protein progress, with Log and Chat controls that open those tabs.

Steps

1. Open the Coach tab.
2. Ask a fitness, nutrition, training, sleep, or recovery question in plain language.
3. Review any confirmation card before applying a target, remembering a fact, or logging food or a workout.

With permission, replies can use logged meals, goals, coach memory, and relevant Apple Health or Health Connect context. AI processing consent is required.

Steps

1. Open Coach and tap the + button.
2. Choose Analyze Restaurant Menu.
3. Add up to four clear menu photos or screenshots.
4. Optionally provide the restaurant name or what you want from the meal.
5. Tap Find my best options.

Restaurant nutrition remains an estimate unless the menu supplies it. Nothing is logged just because Coach recommends it. Always confirm allergy and cross-contact information with restaurant staff.

Connect on iPhone

1. Open Profile.
2. Tap Connect Apple Health.
3. Choose the categories you want to share with MacroMotive.

Connect on Android

1. Open Profile.
2. In Data sources, tap Health Connect.
3. Read the explanation and choose Connect.
4. Choose the Health Connect categories you want to share with MacroMotive.

Review or change access

On iPhone, open Apple's Health app, tap your profile picture, then go to Privacy → Apps → MacroMotive. On Android, open Health Connect, then review App permissions for MacroMotive. Health access is optional and read-only; manual meal logging works without it.

Open Profile and find the AI processing section. Tap Allow AI processing to enable AI meal analysis and coaching, or Withdraw consent to turn those features off without deleting your account.

Steps

1. Open Coach and say what workout you completed, how long it lasted, and when it occurred.
2. Review the workout card, including activity, duration, time, and estimated active calories.
3. Tap Log workout to add it to your daily log, or Dismiss to leave it unlogged.

The calorie figure is a high-level estimate based on the activity, duration, and your latest weight. It was not measured by Apple Health. A manually logged workout can later be deleted from Today by swiping its row to the left.

Steps

1. Ask Coach to help adjust your targets, goal, weight, or a missing body detail.
2. Review every value on the Suggested targets or Confirm profile detail card.
3. Tap Apply to save the displayed changes, or Dismiss to leave your profile unchanged.

Coach text alone does not change your settings. A displayed proposal is saved only after you tap Apply. You can review or edit the resulting values later under Profile.

Steps

1. Tell Coach what you ate, including portions and when you ate it when you know them. 2. For a meal from yesterday or the day before, answer Coach's time question. If the meal matches one of your saved foods, Coach uses that saved meal's foods and macros. 3. Review the foods, portions, calories, macros, and displayed logging time on the meal card. 4. Tap Log now or Log for [time], or tap Dismiss to leave it unlogged.

Coach text by itself does not log food. Only confirming the card writes the meal to your timeline. Coach supports today, yesterday, and the day before yesterday; use the meal editor for older entries. Planned or future meals are not logged as eaten. Open the new meal from its day on Today if it needs correction.

Steps

1. Open Coach and tap the + button beside the message field.
2. Choose Take Photo or Choose Photo.
3. Confirm that Photo attached appears above the message field.
4. Add a question or instruction if useful, then send the message.

Tap the remove control on the attachment preview if you selected the wrong image. Use Analyze Restaurant Menu instead when comparing several menu pages.

Save a memory

1. Tell Coach about a lasting allergy, dietary restriction, injury, or coaching preference.
2. Review the memory card Coach offers.
3. Tap Remember to save it, or Dismiss to leave memory unchanged.

Forget a memory

1. Open Profile → View coach memory.
2. Swipe the memory row to the left.
3. Confirm Forget memory.

Conversation text is not automatically permanent memory. A fact is saved only after you confirm its Remember card.

Steps

1. Open Coach.
2. Tap the New conversation button in the upper-right corner.
3. Confirm Clear conversation.

This removes the chat history but keeps your saved targets and goals. To review or remove standing allergies, injuries, and preferences, use Profile → View coach memory.

Copy

1. Touch and hold a text message in Coach.
2. Tap Copy.

Report a Coach reply

1. Touch and hold the Coach reply and tap Report.
2. Choose why you are reporting it and optionally add a note.
3. Tap Submit report.

Only completed Coach replies can be reported. User messages can be copied but do not show the Report action.

Join a group with a code

1. Open the Profile tab and tap Groups & challenges.
2. Tap Join with a code.
3. Enter the invite code from your gym or from whoever invited you, then tap Continue.
4. Read what the group can and can never see.
5. Enter Your name in this group and tap Agree & join.

Create a group

1. Open the Profile tab and tap Groups & challenges.
2. Tap Create a group.
3. Enter a Group name (up to 60 characters) and Your name in this group (up to 40 characters).
4. Tap Create group. You become the group's manager.

Invite people

1. Open the group from Groups & challenges.
2. Tap Text an invite to send the code from Messages, or Share to use the iOS share sheet.

Invites are always sent from your own phone; MacroMotive never messages anyone for you. A group you create holds up to 10 members. Gym groups are set up by the gym, not in the app; you join them with the gym's code.

Leave a group

1. Open the group and tap Leave this group, or touch and hold the group in the list and tap Leave group.
2. Confirm Leave.

You come off the roster right away. Your own logs and history are not affected.

Notes

Your name in a group is the only thing other members know you by, so a nickname is fine. A manager can tap Generate a new code to replace the invite code; the old code stops working, and nobody already in the group is removed. If a code doesn't work, check it for typos, ask for a fresh one, or the group may be full.

What the group sees

In a group you created or were invited to, the other members can see:

1. The display name you chose for that group.
2. Whether you logged anything in the last 7 days.
3. Your progress in challenges you choose to join: whether each day counted, your lives, and your days completed.

In a gym group, the gym that runs the group can see the same things as the members.

What the group never sees

Nobody in a group, including its creator or the gym, sees your weight, body fat, or any body measurement; your calories, macros, or anything you ate; your sleep, heart rate, or other health data; or your conversations with the AI coach.

How challenges protect this

Challenges are scored with a checkmark per day, never a number. A protein challenge is measured against your own protein target, and the group only sees whether the day counted, not how much protein you had. No challenge can be scored on weight, calories, or body composition.

Notes

You see this list before joining and agree to it with Agree & join. You can see it again on the group's page under What this group sees. Leaving a group removes you from its roster right away.

Steps

1. Open the Profile tab, tap Groups & challenges, and open a group you manage.
2. Tap New challenge.
3. Pick a challenge.
4. Choose Chain or Survivor.
5. Set the number of lives each member gets (1 to 5; 3 by default).
6. Tap Start challenge. It starts today, and the group can join from the group page or the Today tab.

The challenges

Log something every day: a day counts when you log at least one meal. Three meals every day: a day counts when you log three or more meals. Hit your protein target every day: a day counts when you reach your own protein target; nobody sees the number. Log a workout every day: a day counts when you log a workout, and lives work as rest days.

Chain or Survivor

Chain is co-op. The group builds one shared streak, counted in days. Each member has their own lives, and a missed day costs that member a life. The chain keeps running until someone misses with no lives left, which ends it for everyone. The group's longest chain is shown as its record.

Survivor is competitive. A miss costs you a life, and a miss with no lives left knocks you out. The last member standing wins. Members can only join a Survivor challenge on its first day.

Notes

Only a group's manager can start a challenge. Challenges run until they end on their own; there is no fixed length. A manager can remove a challenge for everyone by opening it and tapping Delete challenge; this can't be undone.

Join a challenge

1. On the Today tab, tap challenges you can join, or open the group from Profile > Groups & challenges.
2. Tap the challenge, then tap Join this challenge.

If you join on the challenge's first day, that day counts. If you join later, the day you join doesn't count, so you can't miss it; every day after that does.

Check in

Just log as usual. When something you log meets the challenge, a banner says That counts for today (or names each challenge it counted for). On the Today tab, the challenge card shows the chain or how many are still standing, your status, and which teammates still owe today. Swipe the card to see other challenges, and tap it to open the challenge.

Status icons

A checkmark means the day counted. An empty ring means the day is still open. A red ring with Missed yesterday means yesterday closed as a miss and cost a life; today is still open and can still count. A broken heart means the member is out. A dash means today doesn't count for that member, for example on their join day.

Nudge a teammate

1. Open the challenge, or use the Today card.
2. Tap Nudge next to a teammate who hasn't checked in yet.

A nudge sends a fixed reminder with your name; it never includes any of your data. You can nudge each teammate once a day per challenge. Nudges only go out between 8 AM and 9 PM in the teammate's time zone, and a member receives at most 3 nudges a day. To stop receiving nudges for a challenge, open it and turn off Let teammates nudge me.

Leave a challenge

1. Open the challenge and tap Leave this challenge (in Survivor, Leave (counts as a forfeit)).

The days you already completed stay on the record. In Chain, you can rejoin later; the time you were away isn't held against the group, and the day you rejoin doesn't count. In Survivor, leaving is a forfeit, and you can't rejoin after the first day.

Notes

MacroMotive may send challenge reminders, such as when a chain or your last life is at risk, and results when a challenge ends. These arrive between 8 AM and 9 PM your time.

Chain

A Chain ends the first time a member misses a day with no lives left. The chain's length is the number of days it ran, and the group's longest chain is kept as its record. Start a new Chain to try to beat it.

Survivor

A miss with no lives left knocks that member out. When one member is left standing, they win. If the last members are all knocked out on the same day, they share the win; a member who left the challenge never shares a win. If fewer than two people joined by the end of the first day, the challenge is called off.

See the results

1. Open the group from Profile > Groups & challenges.
2. Tap the ended challenge to see Final standings, including days completed and who won.

Notes

A day is decided once it ends in each member's own time zone, so a missed day shows up the next day. Results stay on the group page after a challenge ends. A challenge a manager deletes disappears for everyone without a result.

Steps

1. Open Profile.
2. Tap Edit beside Daily targets or Body & goal.
3. Update calories, protein, carbohydrates, fat, current or target weight, and goal as needed.
4. Add missing height, age, or calorie-estimate equation details if you want them used for personalized estimates.
5. Tap Save.

Body details are optional. The calorie-estimate equation choice is not a gender-identity field. Apple Health values remain available unless you deliberately replace a field with a manual update.

Start Pro

1. Open Profile → Subscription.
2. Tap Upgrade to MacroMotive Pro.
3. Choose a plan and confirm Start free trial or Subscribe with Apple.

Manage or cancel

Open Profile → Subscription → Manage subscription. Apple handles renewal and cancellation in your App Store subscription settings.

Restore

Open the Pro purchase screen and tap Restore purchases. Use the same Apple Account that made the purchase. Restoring does not create a second charge.

Steps

1. Open Profile and scroll to Preferences.
2. Under Weight units, choose lb or kg.

The setting changes how weight and height are displayed and entered throughout the app. Stored values and existing progress are converted rather than replaced.

Steps

1. Open Profile and scroll to Account.
2. Tap Support ID.
3. Paste the copied full ID into your support message when requested.

The screen displays only the last characters for quick recognition, but tapping copies the complete identifier. A Support ID is not a password or session token.

Steps

1. Open Profile and scroll to Account.
2. Tap Sign out.

Signing out removes the current session and clears user-specific local caches, widget data, Live Activities, and Health sync state from the device. It does not delete the account, timeline, Coach memory, subscription, or other cloud data.

Delete on iPhone

1. Open Profile and scroll to Account.
2. Tap Delete account & data.
3. Read the warning and tap Delete everything.

Delete on Android

1. Open Profile and scroll to Account.
2. Tap Delete account & data.
3. Read the warning and tap Delete.

Deletion permanently erases the timeline, Coach messages and memory, photos, profile, and other account data. It does not cancel an App Store or Google Play subscription; use Manage Subscription separately before deleting if you want to stop renewal. If you cannot access the app, request deletion at macromotive.app/delete-account.

From Profile

1. Open Profile and scroll to Account.
2. Tap Sources & Methodology.

You can also open the same sheet from the information control on Today's Nutrition card or from the methodology note in the detailed Daily Energy view. The screen explains source data, formulas, estimates, and important limitations.