> 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://monthly-calender-widgets.gitbook.io/docs/privacy-and-support/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.