Widget reference
Widget reference
Compare Weather Fusion widget kinds, supported sizes, and content.
| Widget | Families | Content |
|---|---|---|
| Real Time | Small, Medium, Large, and Extra Large portrait on iPhone with iOS 27 | Current-condition presentation with station measurements from the selected preset; Medium and Large can use gauges, and Extra Large shows up to 14 measurements |
| Real Time on the Lock Screen | Circular, rectangular, and inline on iPhone and iPad | Current Conditions or exact station measurements; one choice in circular, up to two items in rectangular, and up to three in inline |
| Real Time Details | Small, Medium, Large, and Extra Large portrait on iPhone with iOS 27 | A compact grid of exact station measurements with up to 4, 6, 12, or 20 values respectively |
Home Screen and desktop configuration
Each widget configuration includes:
- a visible Weather Fusion station;
- a Preset: Essentials, Temperature & Humidity, Wind & Rain, Air Quality, or Custom;
- with Custom, an ordered Measurements list of exact metrics from the station’s catalog, each with its sensor, statistic, and time window;
- the system widget family selected when the widget was added.
A new widget starts with the station selected in Weather Fusion and the Essentials preset. Each widget keeps its own station and preset.
Preset choices are resolved against the station’s mirrored metric catalog. Each preset selects available values from that station, and smaller families show fewer measurements than larger families. Custom shows the chosen measurements in their configured order, up to the family’s capacity. Wind and gust direction can accompany the corresponding speed measurement in one slot. For an Ecowitt station with two rain gauges, widgets show rain from the ordinary rain gauge.
Exact choices include numeric values and timestamps. Real Time Details can present compatible event times, while gauge-oriented Real Time choices focus on current numeric readings. Descriptive text payloads are presented in Observations and detailed observation surfaces.
The exact choices can include current temperature and comfort metrics, humidity, rain windows, wind, pressure, solar and UV, lightning, air quality, indoor conditions, and supported extra sensor channels. Lightning widgets show how far away the storm is. See Supported measurements for the broader normalized catalog.
Lock Screen configuration
Circular Real Time widgets use Show to choose Current Conditions or one exact measurement. Rectangular and inline widgets offer Current Conditions and Custom presets. Custom exposes an ordered Items list with a capacity of two in rectangular widgets and three in inline widgets. Each item can be Current Conditions or an exact measurement from the selected station.
Inline content adapts to the available width, so fewer items can appear than were selected. Available choices depend on the station’s measurements. See Configure widgets for the procedure.
Data and refresh behavior
Widgets read a privacy-bounded mirror maintained by Weather Fusion and can perform supported direct refresh work. Widget values can therefore lag briefly behind an open app during provider, system, or network delays. The displayed observation age indicates freshness. For Airport (METAR) stations, the condition icon and description use weather and sky conditions from the airport report. Other stations can use Apple Weather context.
Wind displays follow Settings › Appearance › Wind compass. Wind barb uses knots rounded to the nearest 5 knots; numeric readings keep the selected wind-speed unit.
Tapping a valid widget opens Weather Fusion for its configured station. If that station was hidden or removed, Weather Fusion opens station management so the configuration can be repaired.
Use the system widget editor to change the station, preset, or measurements. Open the app after changing station, sensor, or provider configuration so the widget mirror can be updated.