> For the complete documentation index, see [llms.txt](https://monthly-calender-widgets.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://monthly-calender-widgets.gitbook.io/docs/privacy-and-support/troubleshooting.md).

# Troubleshooting

## Widgets show blank or "No Events"

**Likely cause:** Calendar permission is not granted or no calendars are enabled.

**Fix:**

1. Go to iOS **Settings** > **Privacy & Security** > **Calendars**.
2. Find **Monthly Calendar Widgets** and ensure it has **Full Access** (not "Write Only" or "None").
3. Open the app, go to **Settings** > **Data Sources** > **Calendar (iOS)**.
4. Make sure at least one calendar is toggled **on**.
5. Open the app once to trigger a widget data refresh.

## Widgets not updating / look frozen

**Likely cause:** iOS has not refreshed the widget, or the snapshot data is stale.

**Fix (try in order):**

1. **Open the app** -- Launching the app triggers an immediate widget data refresh.
2. **Change a setting** -- Toggle any setting (theme, color, calendar toggle) and wait a few seconds. This forces iOS to refresh the widget.
3. **Remove and re-add the widget** -- Long press the widget > Remove Widget. Then add it again from the widget gallery.
4. **Restart your device** -- Clears all widget caches and forces a fresh load.

## Google Calendar sync not working

**Likely cause:** Network issue, sync limit reached, or authentication expired.

**Fix:**

1. **Check your internet** -- Google sync requires an active internet connection.
2. **Check the sync limit** -- Free accounts get 2 syncs per week (Pro is unlimited). The remaining count is shown in the Google Calendar section under Data Sources.
3. **Verify the account** -- Settings > Data Sources > Google Calendar. Confirm the correct account is connected.
4. **Reconnect** -- Disconnect your Google account and reconnect. This refreshes the OAuth tokens.

## Missing events

**Likely cause:** Calendar not enabled, source not synced, or event is outside the visible date window.

**Fix:**

1. **Check calendar toggles** -- Settings > Data Sources. Ensure the calendar containing the event is enabled.
2. **Sync Google Calendar** -- If the event was recently added to Google, tap Sync Now to fetch the latest data.
3. **Check the date range** -- Widgets display events within the sync window (2 years past to 1 year future). Very far-future events beyond 1 year may not appear.

## Calendar colors look wrong

**Likely cause:** Using iOS Calendar colors instead of Google Calendar colors.

**Fix:**

* For exact Google colors, connect **Google Calendar** as a data source and sync. iOS Calendar uses its own color palette which differs from Google's web interface.
* To keep original event colors in Custom Widgets: **Edit any widget -> Display Options -> Preserve Event Colors** (toggle on). Toggle it off to use a single accent color.

## Cannot create or edit events

**Likely cause:** Calendar permission level or read-only calendar.

**Fix:**

1. **Check permission level** -- iOS Settings > Privacy & Security > Calendars. Ensure the app has **Full Access**.
2. **Check the calendar type** -- Subscribed calendars and some shared calendars are read-only.
3. **Try a different calendar** -- Select a writable calendar (e.g., your primary iCloud or Google calendar).

## Widget shows wrong month or week

**Likely cause:** Widget cache is stale or navigation offset is stuck.

**Fix:**

1. Open the app to trigger a refresh.
2. If the widget has navigation buttons, tap them to return to the current month/week.
3. Remove and re-add the widget if it remains stuck.

## Pro features not working after purchase

**Likely cause:** Purchase not synced or app not updated.

**Fix:**

1. Open the app and go to the paywall/Pro area.
2. Tap **Restore Purchases**.
3. Ensure you're signed in with the **same Apple ID** used for the purchase.
4. Check subscription status: iOS Settings > Apple ID > Subscriptions.

## Lock Screen widgets show "PRO" overlay

**Cause:** Lock Screen widgets require Pro. The overlay appears when you don't have an active subscription or lifetime purchase.

**Fix:** Subscribe to Weekly Pro or purchase Lifetime Pro to unlock all Lock Screen widgets.

## App crashes on launch

**Fix:**

1. **Force quit and reopen** -- Swipe up from the app switcher, then reopen.
2. **Update the app** -- Check the App Store for updates.
3. **Restart your device**.
4. **Reinstall** -- Delete and reinstall. Use **Restore Purchases** to recover Pro access.## Stopwatch or timer not appearing in widget**Likely cause:** No active timer/stopwatch set.\*\*Fix:\*\*1. Open the app > Widgets tab.
5. Go to the Timers or Stopwatches section.
6. Ensure you have at least one timer/stopwatch created.
7. Set it as **Active** -- the active one is what appears in Lock Screen widgets.## Still need help?Contact us at **<support@calndly.app>** with:- Your iOS version and device model.

* Whether you use iOS Calendar, Google Calendar, or both.
* A screenshot of the issue if possible.