Author
system Submitted
Jul 31, 2026 5:13pm Reviewed
Jul 31, 2026 5:13pm Summary
Imported from the mobieusHealth knowledge base, rebranded for this tenant
+
''Part of the [[Using the iOS app|Loopa iOS app]] guide.''
−
''Part of the [[Using the iOS app|Loopa app]] guide. Also on Android.''
+
The '''Home Screen widgets''' are the small Loopa glance panels you can pin to your iPhone Home Screen and Lock Screen. The app ships four of them — Today's Page, Fuel, Water and Weight — alongside the [[Fasting Live Activity]] that appears only while a fast is running. Every widget paints instantly from a shared snapshot the app keeps up to date, and the Today and Water widgets carry a tap-to-log button so you can add water without opening the app. For the app itself, start at [[Using the iOS app]].
−
The '''Home Screen widgets''' are the small Loopa glance panels you can pin to your phone's Home Screen. There are nineteen to choose from on iOS and eighteen on Android, one for nearly every number Loopa tracks, so you can put the one you actually check where you will see it. On iOS they also work on the Lock Screen, and the [[Fasting Live Activity]] appears on its own while a fast is running.
−
−
Every widget paints instantly from a snapshot the app keeps up to date, so it never sits blank while it thinks. A few carry a button that logs without opening the app. For the app itself, start at [[Using the iOS app]] or [[Using the Android app]].
''General wellness tracking, not medical advice.''
+
== The Today's Page widget ==
−
== The full list ==
+
'''Today's Page''' is the combined glance — the same opening view as [[Today's Page]] inside the app. It comes in one size, medium (the wide rectangle), and shows three things side by side:
−
The gallery is grouped the way you would look for something.
+
* A '''water ring''' with the ounces you've logged today in the middle, filling toward your daily goal. Under the ring is a '''+8''' button — tap it and 8 ounces go straight into today's log, no app launch needed. The ring turns green once you hit your goal.
+
* '''Fuel''' — the calories you have left today (or "KCAL OVER" in red if you've gone past your target). It reads "—" until your targets are set up.
+
* '''Move''' — today's step count, when steps are available.
−
=== Fuel and macros ===
+
Along the bottom it stamps "Today's Page" and, once you've been logging for a while, "Day N on record" — the count of days you have logged.
−
* '''Fuel''': calories left today, with protein, carbs and fat gauges. Small, medium, and Lock Screen rectangular.
−
* '''Eaten Today''': calories logged so far. Small, Lock Screen circular and inline.
−
* '''Protein''': protein logged today against your target. Small, medium, and all three Lock Screen shapes.
−
* '''Net Carbs''': net carbs against your target. Small, medium, Lock Screen circular and rectangular.
−
* '''Fat''': fat against your target. Same sizes as Net Carbs.
−
* '''Macros''': protein, carbs and fat side by side. Small, medium, large, Lock Screen rectangular.
+
== The Fuel widget ==
−
=== Hydration and movement ===
+
'''Fuel''' answers the one question you check most: how much room is left in today's calorie budget. It comes in small and medium sizes, plus a Lock Screen rectangular size.
−
* '''Water''': today's hydration ring, one tap from +8 oz. Small, medium, Lock Screen circular and inline.
−
* '''Steps''': today's steps against a 10,000 mark. Small, medium, and all three Lock Screen shapes.
+
* '''Small''' leads with the big calories-left numeral and stacks three mini gauges under it — P (protein), C (carbs) and F (fat), each a small bar showing grams used against your target.
+
* '''Medium''' shows the same numeral labelled "Fuel · The Log", the "X / Y kcal filed" line beneath it, and the P/C/F gauges to the right.
+
* The '''Lock Screen''' version is a single line: "N KCAL LEFT" with the P/C/F grams after it.
−
=== Body ===
+
If you're over your target the numeral and label turn red and read "kcal over". Until your fuel targets are set the numeral shows "—". The Fuel widget is read-only — it doesn't log anything, it just reports.
−
* '''Weight''': current weight and the 7-day trend. Small, Lock Screen circular, rectangular and inline.
−
* '''Weight Trend''': your latest weigh-in against the 7-day average, which is the number that ignores daily noise. Small, medium, Lock Screen rectangular and inline.
+
== The Water widget ==
−
=== Rhythm ===
+
'''Water''' is the hydration ring on its own, and like the Today widget it's tap-to-log. It comes in small and medium sizes, plus Lock Screen circular and inline sizes.
−
* '''Fasting''': hours elapsed in your current fasting window. Small, medium, and all three Lock Screen shapes.
−
* '''Days Logged''': how many days you have on record. Small, Lock Screen circular and inline.
−
* '''This Week''': your logging streak and the last seven days as dots. Small and medium.
+
* '''Small''' shows the ring with ounces "of N oz" in the centre and a '''+8 OZ''' button under it. The button logs 8 ounces instantly — it uses the very same action Siri uses (see [[Siri and Shortcuts]]).
+
* '''Medium''' shows a larger ring, "TARGET MET" or "N OZ TO GO", the "X / Y oz filed today" line, and the +8 OZ button.
+
* The '''Lock Screen''' circular version is a small drop gauge with your ounces; the inline version sits next to the clock as "X/Y oz" (or "Water met").
−
=== Vitals ===
+
The ring turns green when you reach your goal. The tap-to-log button appears on the Home Screen sizes; the Lock Screen circular and inline versions are display-only. For the full screen behind this widget see [[The Water screen]].
−
* '''Vitals''': your latest blood pressure and resting heart rate with a seven-day direction. Medium only, and deliberately '''never on the Lock Screen'''.
+
== The Weight widget ==
−
Glucose and INR are handled differently from the rest. They show '''when''' the reading was taken rather than the reading itself, because a number on your Home Screen is readable by anyone who glances at your phone. The full values are in the app on [[The Vitals screen]].
+
'''Weight''' shows your current weight and which way the trend is pointing. It comes in a small Home Screen size plus Lock Screen circular, rectangular and inline sizes.
−
=== The whole day at once ===
+
* '''Small''' shows the big weight number, its unit (lb or kg), and a '''7-day trend''' arrow underneath — current weight against the 7-day average. Down is the win, so a downward arrow and the amount render in green; up renders in red; holding steady shows a dash.
+
* The Lock Screen sizes carry the same number and arrow in the tighter shapes.
−
* '''Today's Page''': water, fuel and movement in one glance, the same opening view as [[Today's Page]] in the app. Medium.
−
* '''Today's Rings''': fuel, water and movement as three rings. Small, medium, large.
−
* '''What's Left''': calories, protein and water still to go today. Small, medium, large, Lock Screen rectangular.
+
You need at least a couple of weigh-ins before the trend can be drawn — until then the widget says "Log 2+ days for trend" (or "7-day trend pending" on the Lock Screen). The Weight widget is read-only.
−
=== Getting somewhere fast ===
+
== Adding a widget to your Home Screen ==
−
* '''Quick Log''': food, water, weight and activity, one tap each. Medium. The buttons open the right screen rather than logging blind, because Loopa has to ask what you ate.
+
Widgets are added through iOS, the same way as any other app's:
−
=== Pick a Metric (iOS only) ===
+
* Touch and hold an empty part of the Home Screen until the icons jiggle, then tap the '''+''' (Edit / add) button in the corner.
+
* Search for "Loopa".
+
* Swipe between the available sizes for the widget you want, then tap '''Add Widget''' and place it.
−
'''Pick a Metric''' is the one configurable widget. Add it, then choose which number it shows: calories, a macro, water, steps, weight, fasting or your streak. It comes in every size including all three Lock Screen shapes. It exists for people who would rather choose than scroll the gallery.
+
To place a Lock Screen widget, touch and hold the Lock Screen, tap '''Customize''', choose the widget area, and pick the Loopa circular, rectangular or inline widget there.
−
This is the one widget with no Android counterpart, because Android widgets have no equivalent way to be configured after you place them. Everything it can show is available as its own fixed widget on both platforms.
−
−
== The ones you can tap ==
−
−
'''Water''' and '''Today's Page''' each carry a '''+8''' button. Tapping it puts 8 ounces straight into today's log and repaints every Loopa widget right away. The app never opens. It is the same action Siri uses (see [[Siri and Shortcuts]]).
−
−
Everything else is read-only by design. A widget button should either finish the job or not pretend to: logging water can finish without asking anything, whereas "add food" cannot, so those tiles open the app instead.
−
−
== Adding a widget ==
−
−
'''On iPhone:''' touch and hold an empty part of the Home Screen until the icons jiggle, tap the '''+''' in the corner, search for "Loopa", swipe between the sizes for the widget you want, then tap '''Add Widget'''.
−
−
For a Lock Screen widget, touch and hold the Lock Screen, tap '''Customize''', choose the widget area, and pick the Loopa circular, rectangular or inline widget there.
−
−
'''On Android:''' touch and hold an empty part of the Home screen, tap '''Widgets''', scroll to Loopa, then touch and hold the one you want and drag it into place. Android has no Lock Screen widgets, so the Lock Screen sizes above are iOS only.
== How the numbers stay current ==
+
Each widget draws immediately from a snapshot the app writes to a shared App Group, so it never shows a blank while it thinks. On top of that it quietly refreshes the numbers from your account whenever it can — on a roughly 15-minute cadence, and again every time you log something in the app or through a widget button, Siri, or the Watch. Any water you add from a widget's +8 button reloads all the widgets right away.
−
Each widget draws immediately from a snapshot the app writes to shared storage, which is why it is never blank. On top of that it refreshes from your account whenever it can: on a roughly 15-minute cadence, and again every time you log something in the app, from a widget button, through Siri, or on the Watch. Adding water from a widget reloads all of them at once.
== Before you sign in ==
+
If you haven't signed in yet, or the app hasn't pulled its first summary, a widget shows a "Signed out" card asking you to open Loopa. Once you're signed in and have logged or synced anything, the real numbers take over.
−
If you have not signed in yet, or the app has not pulled its first summary, a widget shows a "Signed out" card asking you to open Loopa. Once you are signed in and have logged or synced anything, the real numbers take over.
== See also ==
* [[Today's Page]]
* [[The Water screen]]
−
* [[The Vitals screen]]
* [[Siri and Shortcuts]]
* [[Fasting Live Activity]]
* [[Using the iOS app]]
−
* [[Using the Android app]]
[[Category:The iOS app]]
+
[[Category:mobieusHealth]]
−
[[Category:Loopa]]
−
''Part of the [[Using the iOS app|Loopa iOS app]] guide.''
The '''Home Screen widgets''' are the small Loopa glance panels you can pin to your iPhone Home Screen and Lock Screen. The app ships four of them — Today's Page, Fuel, Water and Weight — alongside the [[Fasting Live Activity]] that appears only while a fast is running. Every widget paints instantly from a shared snapshot the app keeps up to date, and the Today and Water widgets carry a tap-to-log button so you can add water without opening the app. For the app itself, start at [[Using the iOS app]].
''General wellness tracking, not medical advice.''
== The Today's Page widget ==
'''Today's Page''' is the combined glance — the same opening view as [[Today's Page]] inside the app. It comes in one size, medium (the wide rectangle), and shows three things side by side:
- A '''water ring''' with the ounces you've logged today in the middle, filling toward your daily goal. Under the ring is a '''+8''' button — tap it and 8 ounces go straight into today's log, no app launch needed. The ring turns green once you hit your goal.
- '''Fuel''' — the calories you have left today (or "KCAL OVER" in red if you've gone past your target). It reads "—" until your targets are set up.
- '''Move''' — today's step count, when steps are available.
Along the bottom it stamps "Today's Page" and, once you've been logging for a while, "Day N on record" — the count of days you have logged.
== The Fuel widget ==
'''Fuel''' answers the one question you check most: how much room is left in today's calorie budget. It comes in small and medium sizes, plus a Lock Screen rectangular size.
- '''Small''' leads with the big calories-left numeral and stacks three mini gauges under it — P (protein), C (carbs) and F (fat), each a small bar showing grams used against your target.
- '''Medium''' shows the same numeral labelled "Fuel · The Log", the "X / Y kcal filed" line beneath it, and the P/C/F gauges to the right.
- The '''Lock Screen''' version is a single line: "N KCAL LEFT" with the P/C/F grams after it.
If you're over your target the numeral and label turn red and read "kcal over". Until your fuel targets are set the numeral shows "—". The Fuel widget is read-only — it doesn't log anything, it just reports.
== The Water widget ==
'''Water''' is the hydration ring on its own, and like the Today widget it's tap-to-log. It comes in small and medium sizes, plus Lock Screen circular and inline sizes.
- '''Small''' shows the ring with ounces "of N oz" in the centre and a '''+8 OZ''' button under it. The button logs 8 ounces instantly — it uses the very same action Siri uses (see [[Siri and Shortcuts]]).
- '''Medium''' shows a larger ring, "TARGET MET" or "N OZ TO GO", the "X / Y oz filed today" line, and the +8 OZ button.
- The '''Lock Screen''' circular version is a small drop gauge with your ounces; the inline version sits next to the clock as "X/Y oz" (or "Water met").
The ring turns green when you reach your goal. The tap-to-log button appears on the Home Screen sizes; the Lock Screen circular and inline versions are display-only. For the full screen behind this widget see [[The Water screen]].
== The Weight widget ==
'''Weight''' shows your current weight and which way the trend is pointing. It comes in a small Home Screen size plus Lock Screen circular, rectangular and inline sizes.
- '''Small''' shows the big weight number, its unit (lb or kg), and a '''7-day trend''' arrow underneath — current weight against the 7-day average. Down is the win, so a downward arrow and the amount render in green; up renders in red; holding steady shows a dash.
- The Lock Screen sizes carry the same number and arrow in the tighter shapes.
You need at least a couple of weigh-ins before the trend can be drawn — until then the widget says "Log 2+ days for trend" (or "7-day trend pending" on the Lock Screen). The Weight widget is read-only.
== Adding a widget to your Home Screen ==
Widgets are added through iOS, the same way as any other app's:
- Touch and hold an empty part of the Home Screen until the icons jiggle, then tap the '''+''' (Edit / add) button in the corner.
- Search for "Loopa".
- Swipe between the available sizes for the widget you want, then tap '''Add Widget''' and place it.
To place a Lock Screen widget, touch and hold the Lock Screen, tap '''Customize''', choose the widget area, and pick the Loopa circular, rectangular or inline widget there.
== How the numbers stay current ==
Each widget draws immediately from a snapshot the app writes to a shared App Group, so it never shows a blank while it thinks. On top of that it quietly refreshes the numbers from your account whenever it can — on a roughly 15-minute cadence, and again every time you log something in the app or through a widget button, Siri, or the Watch. Any water you add from a widget's +8 button reloads all the widgets right away.
== Before you sign in ==
If you haven't signed in yet, or the app hasn't pulled its first summary, a widget shows a "Signed out" card asking you to open Loopa. Once you're signed in and have logged or synced anything, the real numbers take over.
== See also ==
- [[Today's Page]]
- [[The Water screen]]
- [[Siri and Shortcuts]]
- [[Fasting Live Activity]]
- [[Using the iOS app]]
[[Category:The iOS app]] [[Category:mobieusHealth]]
''Part of the [[Using the iOS app|Loopa iOS app]] guide.'' The '''Home Screen widgets''' are the small Loopa glance panels you can pin to your iPhone Home Screen and Lock Screen. The app ships four of them — Today's Page, Fuel, Water and Weight — alongside the [[Fasting Live Activity]] that appears only while a fast is running. Every widget paints instantly from a shared snapshot the app keeps up to date, and the Today and Water widgets carry a tap-to-log button so you can add water without opening the app. For the app itself, start at [[Using the iOS app]]. ''General wellness tracking, not medical advice.'' == The Today's Page widget == '''Today's Page''' is the combined glance — the same opening view as [[Today's Page]] inside the app. It comes in one size, medium (the wide rectangle), and shows three things side by side: * A '''water ring''' with the ounces you've logged today in the middle, filling toward your daily goal. Under the ring is a '''+8''' button — tap it and 8 ounces go straight into today's log, no app launch needed. The ring turns green once you hit your goal. * '''Fuel''' — the calories you have left today (or "KCAL OVER" in red if you've gone past your target). It reads "—" until your targets are set up. * '''Move''' — today's step count, when steps are available. Along the bottom it stamps "Today's Page" and, once you've been logging for a while, "Day N on record" — the count of days you have logged. == The Fuel widget == '''Fuel''' answers the one question you check most: how much room is left in today's calorie budget. It comes in small and medium sizes, plus a Lock Screen rectangular size. * '''Small''' leads with the big calories-left numeral and stacks three mini gauges under it — P (protein), C (carbs) and F (fat), each a small bar showing grams used against your target. * '''Medium''' shows the same numeral labelled "Fuel · The Log", the "X / Y kcal filed" line beneath it, and the P/C/F gauges to the right. * The '''Lock Screen''' version is a single line: "N KCAL LEFT" with the P/C/F grams after it. If you're over your target the numeral and label turn red and read "kcal over". Until your fuel targets are set the numeral shows "—". The Fuel widget is read-only — it doesn't log anything, it just reports. == The Water widget == '''Water''' is the hydration ring on its own, and like the Today widget it's tap-to-log. It comes in small and medium sizes, plus Lock Screen circular and inline sizes. * '''Small''' shows the ring with ounces "of N oz" in the centre and a '''+8 OZ''' button under it. The button logs 8 ounces instantly — it uses the very same action Siri uses (see [[Siri and Shortcuts]]). * '''Medium''' shows a larger ring, "TARGET MET" or "N OZ TO GO", the "X / Y oz filed today" line, and the +8 OZ button. * The '''Lock Screen''' circular version is a small drop gauge with your ounces; the inline version sits next to the clock as "X/Y oz" (or "Water met"). The ring turns green when you reach your goal. The tap-to-log button appears on the Home Screen sizes; the Lock Screen circular and inline versions are display-only. For the full screen behind this widget see [[The Water screen]]. == The Weight widget == '''Weight''' shows your current weight and which way the trend is pointing. It comes in a small Home Screen size plus Lock Screen circular, rectangular and inline sizes. * '''Small''' shows the big weight number, its unit (lb or kg), and a '''7-day trend''' arrow underneath — current weight against the 7-day average. Down is the win, so a downward arrow and the amount render in green; up renders in red; holding steady shows a dash. * The Lock Screen sizes carry the same number and arrow in the tighter shapes. You need at least a couple of weigh-ins before the trend can be drawn — until then the widget says "Log 2+ days for trend" (or "7-day trend pending" on the Lock Screen). The Weight widget is read-only. == Adding a widget to your Home Screen == Widgets are added through iOS, the same way as any other app's: * Touch and hold an empty part of the Home Screen until the icons jiggle, then tap the '''+''' (Edit / add) button in the corner. * Search for "Loopa". * Swipe between the available sizes for the widget you want, then tap '''Add Widget''' and place it. To place a Lock Screen widget, touch and hold the Lock Screen, tap '''Customize''', choose the widget area, and pick the Loopa circular, rectangular or inline widget there. == How the numbers stay current == Each widget draws immediately from a snapshot the app writes to a shared App Group, so it never shows a blank while it thinks. On top of that it quietly refreshes the numbers from your account whenever it can — on a roughly 15-minute cadence, and again every time you log something in the app or through a widget button, Siri, or the Watch. Any water you add from a widget's +8 button reloads all the widgets right away. == Before you sign in == If you haven't signed in yet, or the app hasn't pulled its first summary, a widget shows a "Signed out" card asking you to open Loopa. Once you're signed in and have logged or synced anything, the real numbers take over. == See also == * [[Today's Page]] * [[The Water screen]] * [[Siri and Shortcuts]] * [[Fasting Live Activity]] * [[Using the iOS app]] [[Category:The iOS app]] [[Category:mobieusHealth]]
