Home Screen Widgets

Last updated: May 16, 2026

Add a tracker or your world map to your iPhone Home Screen and see your day count at a glance — without opening the app.

What Widgets Do

AtlasDays widgets pull live data from your trip record and display it directly on your Home Screen or Lock Screen. They update automatically as your trip record changes — no manual refresh needed.

You can add:

• a Tracker widget showing days used, days remaining, and a forecast for any tracker you have set up, including a US State tracker when your record has state-tagged trips
• a World Map widget showing your visited-country map

How to Add a Widget

1. Long-press an empty area on your iPhone Home Screen until apps begin to jiggle.
2. Tap the + button in the top-left corner.
3. Search for AtlasDays in the widget gallery.
4. Choose the widget type — Tracker or World Map.
5. Swipe through the size options: small, medium, or large.
6. Tap Add Widget, then drag it into position.
7. Tap the widget to choose which tracker it should display.

You can add multiple widgets to show different trackers side by side.

Widget Sizes

Small

Shows the tracker name, current day count, and status (under limit, at limit, or over limit). Good for a quick one-number glance.

Medium

Shows the tracker name, day count, days remaining or progress, and a compact forecast based on your upcoming trips.

Large

Shows the full tracker summary with forecast detail and the underlying trip context. Best if you track a rule that changes frequently, such as Schengen 90/180.

Tracker Forecasts in Widgets

Medium and large tracker widgets include a forecast derived from your planned future trips. If you have upcoming exact-date trips in the tracker's country set, the widget shows how those trips will affect your count.

• The forecast is as precise as the trips behind it. Planned trips saved as Exact Dates appear in the forecast; Year and Unknown trips do not.
• If you change or cancel a planned trip inside the app, the widget forecast updates automatically.
• An open ongoing trip uses today as the end date in the forecast, so the count moves forward until you close the trip.

Choosing Which Tracker a Widget Shows

After adding a tracker widget, tap it to open the widget configuration. Select the tracker you want from the list. If you only have one tracker, it is selected automatically.

Each widget remembers its own tracker selection independently, so you can have a Schengen widget and a Residence widget on the same Home Screen.

If you choose a US State tracker, the widget follows that tracker exactly. Plain United States trips do not feed a state-specific tracker unless the trips are tagged with that state.

Why a Widget Might Look Wrong

• Widget shows a stale number: widgets refresh periodically. Open the app once to force a refresh if the number looks out of date.
• Widget count differs from the app: make sure the widget is pointing at the correct tracker. Tap the widget to check its tracker selection.
• Widget shows no data: the app needs to have been opened at least once after install for widgets to have data to display.
• Forecast is missing: the forecast only appears when you have upcoming exact-date trips in the tracker's country set. Add or fix those trips inside the app.

World Map Widget

The World Map widget displays a miniature version of your visited-country map, updated from your trip record. It is available in medium and large sizes.

Visited-country counting follows the same rules as the in-app map: a country is visited when you have at least one non-Transit trip there, regardless of trip precision.

The World Map widget is country-level. Individual US state boundaries and state fills appear only in the full-screen in-app map, not in the widget.