---
title: "iOS widgets & Live Activities"
description: "Home screen widgets and Live Activities for Check My Solar put Fox ESS inverter power, battery, grid, and forecasts on your Lock Screen, Home Screen, and Dynamic Island."
---

> Documentation Index
> Fetch the complete documentation index at: https://checkmy.solar/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# iOS widgets & Live Activities

Check My Solar’s **iOS home screen widgets** and **Live Activities** are built for **Fox ESS inverter** owners who want at-a-glance telemetry from Fox Cloud without opening the app-generation, load, battery, import/export, and forecasts stay visible on your **Home Screen**, **Lock Screen**, and **Dynamic Island** (on supported iPhones).

:::note[Requirements]
- **iOS app**: [Check My Solar on the App Store](https://apps.apple.com/us/app/check-my-solar/id6748858406)
- **Linked inverter**: A Fox Cloud account connected in the app (see [Linking your inverter](/docs/getting-started/linking-your-inverter/))
- **Live Activities**: iOS **16.2 or later**, and **Live Activities** turned on for **Check My Solar** under **Settings** (search *Live Activities* or open the app’s settings page)
:::

---

## Home screen widgets

Add widgets from the widget gallery: touch and hold the Home Screen or Today View → **Add Widget** → search for **Check My Solar**.

**Solar Today** is available to all signed-in users. Most other widgets require an **active subscription** (the widget shows a shortcut to upgrade if needed).

### Widget screenshots

These previews use the same image assets as the **Widgets** carousel in the iOS app (notification settings).

<section class="widget-screenshots" aria-label="Home screen widget screenshots">
<p class="widget-screenshots__hint">Swipe (or shift+scroll) to browse widget previews.</p>
<div class="widget-carousel__controls" aria-hidden="true">
<button
  type="button"
  class="widget-carousel__button"
  aria-label="Scroll widget screenshots left"
  onclick="this.closest('.widget-screenshots').querySelector('.widget-carousel').scrollBy({ left: -300, behavior: 'smooth' });"
>
  ←
</button>
<button
  type="button"
  class="widget-carousel__button"
  aria-label="Scroll widget screenshots right"
  onclick="this.closest('.widget-screenshots').querySelector('.widget-carousel').scrollBy({ left: 300, behavior: 'smooth' });"
>
  →
</button>
</div>
<div class="widget-carousel" role="region" aria-label="Widget screenshots carousel">
<figure><img src="https://media.checkmy.solar/widgets/SolarSmall.webp" alt="Solar Today widget, small size, showing daily energy generated" loading="lazy" decoding="async" /><figcaption><strong>Solar Today</strong><span>Small</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/SolarMedium.webp" alt="Solar Today widget, medium size, with hourly bars and totals" loading="lazy" decoding="async" /><figcaption><strong>Solar Today</strong><span>Medium</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/LiveSmall.webp" alt="Solar Live widget, small size, real-time solar status" loading="lazy" decoding="async" /><figcaption><strong>Solar Live</strong><span>Small</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/LiveMedium.webp" alt="Solar Live widget, medium size, live power and stats" loading="lazy" decoding="async" /><figcaption><strong>Solar Live</strong><span>Medium</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/SummaryASmall.webp" alt="Today Summary widget, small, light style" loading="lazy" decoding="async" /><figcaption><strong>Today Summary</strong><span>Small (light)</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/SummaryASmallDark.webp" alt="Today Summary widget, small, dark style" loading="lazy" decoding="async" /><figcaption><strong>Today Summary</strong><span>Small (dark)</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/SummaryAMedium.webp" alt="Today Summary widget, medium size" loading="lazy" decoding="async" /><figcaption><strong>Today Summary</strong><span>Medium</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/SummaryALarge.webp" alt="Today Summary widget, large size" loading="lazy" decoding="async" /><figcaption><strong>Today Summary</strong><span>Large</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/SolarGraphMedium.webp" alt="Solar Graph widget, medium size, day curve" loading="lazy" decoding="async" /><figcaption><strong>Solar Graph</strong><span>Medium</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/LoadSmall.webp" alt="House Load Today widget, small size" loading="lazy" decoding="async" /><figcaption><strong>House Load Today</strong><span>Small</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/LoadMedium.webp" alt="House Load Today widget, medium size with hourly profile" loading="lazy" decoding="async" /><figcaption><strong>House Load Today</strong><span>Medium</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/BatterySmall.webp" alt="Battery widget, small size, charge state" loading="lazy" decoding="async" /><figcaption><strong>Battery</strong><span>Small</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/BatteryMedium.webp" alt="Battery widget, medium size" loading="lazy" decoding="async" /><figcaption><strong>Battery</strong><span>Medium</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/GridSmall.webp" alt="Grid Today widget, small size, import and export" loading="lazy" decoding="async" /><figcaption><strong>Grid Today</strong><span>Small</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/GridMedium.webp" alt="Grid Today widget, medium size" loading="lazy" decoding="async" /><figcaption><strong>Grid Today</strong><span>Medium</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/MonthSmall.webp" alt="Solar Month widget, small size" loading="lazy" decoding="async" /><figcaption><strong>Solar Month</strong><span>Small</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/MonthMedium.webp" alt="Solar Month widget, medium size" loading="lazy" decoding="async" /><figcaption><strong>Solar Month</strong><span>Medium</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/YearSmall.webp" alt="Solar Year widget, small size" loading="lazy" decoding="async" /><figcaption><strong>Solar Year</strong><span>Small</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/YearMedium.webp" alt="Solar Year widget, medium size" loading="lazy" decoding="async" /><figcaption><strong>Solar Year</strong><span>Medium</span></figcaption></figure>
<figure><img src="https://media.checkmy.solar/widgets/ForecastSmall.webp" alt="Solar Forecast widget, small size" loading="lazy" decoding="async" /><figcaption><strong>Solar Forecast</strong><span>Small</span></figcaption></figure>
</div>

</section>

Widgets refresh on a timeline using your stored session and can update in the background; exact refresh timing is controlled by iOS.

### Widget catalog

| Widget | Sizes | What it shows |
|--------|--------|----------------|
| **Solar Today** | Small, medium, large | Energy generated today; **medium** and **large** include an **hourly bar chart** of today’s solar profile and **forecast** context where available |
| **Solar Live** | Small, medium, large | Real-time solar generation and home energy status |
| **Solar Graph** | Small, medium | Today’s solar generation as a **day curve** (generation over the day) |
| **House Load Today** | Small, medium, large | Home consumption today; **medium** and **large** add an **hourly load profile** |
| **Battery** | Small, medium, large | State of charge and today’s battery energy flow; **small** shows dynamic status (e.g. charging / discharging / full / idle) |
| **Grid Today** | Small, medium, large | Energy **imported** and **exported** to the grid today |
| **Solar Month** | Small, medium | Total solar generation **this month** |
| **Solar Year** | Small, medium | Total solar generation **this year** |
| **Solar Forecast** | Small, medium | **Today’s and tomorrow’s** expected solar generation (links to the in-app forecast experience) |
| **Today Summary** | Small, medium, large | A neutral dashboard layout: **today**, **this month**, and **this year** in one widget |

---

## Live Activities (Lock Screen & Dynamic Island)

A **Live Activity** shows **live Fox ESS data**-including **today’s generation**, **battery state of charge** (or **export** when the battery is full), optional **export earnings** (when rates are configured), and **today’s generation forecast**-directly on the **Lock Screen** and in the **Dynamic Island**.

- **Subscription required** - Live Activities start only for subscribed accounts (same rule as premium widgets).
- **Started from the app** - Enable or disable the Live Activity from the in-app solar dashboard when logged in; the native shell coordinates updates while you use the app or when background refreshes run.
- **System settings** - If nothing appears, confirm Live Activities are allowed for Check My Solar under iOS Settings and that **Low Power Mode** is not blocking updates longer than usual.

Live Activities may **end automatically** after several hours of inactivity to save battery; open the app again to resume if needed.

---

## Related

- [PWA & iOS app](/docs/reference/pwa-ios/) - Web vs native app, PWA install, notifications
- [Using Check My Solar on Android](/docs/using-the-app/android/) - Chrome, Vivaldi, PWA install, and home screen shortcuts
- [Dashboard overview](/docs/using-the-app/dashboard-overview/) - What the in-app charts and cards represent
- [Forecast](/docs/using-the-app/forecast/) - How forecasts power widget and Live Activity estimates
- [Changelog](/docs/reference/changelog/) - Recent widget and Live Activity improvements (e.g. hourly profiles, large summary, forecast on widgets)

## Related pages

- [Using the app overview](/docs/using-the-app/)
- [Dashboard overview](/docs/using-the-app/dashboard-overview/)
- [Time views](/docs/using-the-app/time-views/)
- [Forecast](/docs/using-the-app/forecast/)
- [Entity views](/docs/using-the-app/entity-views/)
- [Notifications](/docs/using-the-app/notifications/)
- [Account settings](/docs/using-the-app/account-settings/)

Source: https://checkmy.solar/docs/using-the-app/ios-widgets-live-activities/index.mdx