Notiwise Troubleshooting Guide

Notiwise Documentation

Quick Start

Getting Started

Features

Installation

Troubleshooting

What’s New

---

Troubleshooting Guide

Common issues and step-by-step solutions to get Not iwise working perfectly.

---

Table of Contents

1. Priority Tags Not Being Recognized
2. Reminders Not Appearing
3. Addon Not Loading
4. Settings Not Saving
5. Statistics Not Updating
6. Edge Cases & Special Situations
7. Getting Help

---

1. Priority Tags Not Being Recognized

Problem: You added a priority tag to your event, but Notiwise didn’t process it.

Diagnostic Flowchart

graph TD
    A[Tag not recognized] --> B{Is tag at START of title?}
    B -->|No| C[Move tag to start: !!Meeting vs Meeting !!]
    B -->|Yes| D{Does tag match your custom tags?}
    D -->|No| E[Check settings - use exact tag configured]
    D -->|Yes| F{Is calendar selected in settings?}
    F -->|No| G[Add calendar in Notiwise settings]
    F -->|Yes| H{Is event in the future?}
    H -->|No| I[Notiwise only processes future events]
    H -->|Yes| J{Has event been processed already?}
    J -->|Yes| K[Event already has reminders - working correctly]
    J -->|No| L[Manual process: Use Process Events Now]

Solutions

Solution 1: Check Tag Placement

Problem: Tag is in the wrong location

Fix:

• Tags must be at the start of the title: @@Important Meeting
• Or at the end: Important Meeting @@
• Or in the description (if you enabled “Check Description”)

❌ Wrong:

• Important @@ Meeting (tag in middle)
• Meeting @@extra text (tag followed by text)

✅ Correct:

• @@Important Meeting
• Important Meeting @@
• Description: Meeting notes @@

---

Solution 2: Verify Tag Matches Settings

Problem: Tag doesn’t match your configured tags

Fix:

1. Open Notiwise settings
2. Check Step 2 (Priority Tags)
3. Verify you’re using the exact tag shown
4. Tags are case-sensitive: @@ ≠ @@

Example: If you configured *** but used @@, Notiwise won’t recognize it.

---

Solution 3: Ensure Calendar is Selected

Problem: Event’s calendar isn’t monitored

Fix:

1. Open Notiwise settings
2. Go to Step 1 (Calendar Selection)
3. Check the box next to the calendar containing your event
4. Click “Save Configuration”

---

Solution 4: Check Event is in Future

Problem: Event is in the past

Notiwise only processes future events (within the next 6 months). Past events are ignored.

---

Solution 5: Manual Processing

Problem: Waiting for automatic daily processing

Fix:

1. Open Notiwise dashboard or onboarding
2. Click “Process Events Now”
3. All tagged events will be processed immediately
4. Check your event - reminders should appear!

---

2. Reminders Not Appearing

Problem: Notiwise processed your event (tag was removed) but reminders weren’t added.

Diagnostic Flowchart

graph TD
    A[Reminders not added] --> B{Was tag removed from event?}
    B -->|No| C[See Priority Tags Not Recognized above]
    B -->|Yes| D{Is event within 6 months?}
    D -->|No| E[Events more than 6 months out are skipped]
    D -->|Yes| F{Check Google Calendar reminder limit}
    F -->|At limit| G[Remove some manual reminders]
    F -->|Not at limit| H{Are you looking at correct event?}
    H -->|Unsure| I[Open event, scroll to Notifications section]
    H -->|Yes| J{Do you have edit permissions?}
    J -->|No| K[Request edit access from calendar owner]
    J -->|Yes| L[Contact support - unexpected issue]

Solutions

Solution 1: Verify Event is Within 6 Months

Problem: Event is too far in the future

Notiwise processes events within the next 6 months only.

Fix: Events more than 6 months away will be processed automatically as they get closer.

---

Solution 2: Check Google Calendar Reminder Limit

Problem: Google Calendar has a maximum number of reminders per event

Fix:

1. Open the event in Google Calendar
2. Scroll to “Notifications” section
3. If you see many manual reminders, remove some
4. Process the event again with Notiwise

Google’s limit: Typically 5-10 reminders per event (varies by account type)

---

Solution 3: Verify Edit Permissions

Problem: You don’t have permission to modify the event

Fix:

• If the event is on someone else’s calendar, you need edit access
• Ask the calendar owner to share with “Make changes to events” permission
• Or, if it’s a shared calendar, check your permission level

---

##3. Addon Not Loading

Problem: The Notiwise interface doesn’t appear or won’t load.

Diagnostic Flowchart

graph TD
    A[Addon not loading] --> B{Did you complete installation?}
    B -->|No| C[Visit installation page and authorize]
    B -->|Yes| D{Tried refreshing browser?}
    D -->|No| E[Refresh page: Ctrl+R or Cmd+R]
    D -->|Yes| F{Using supported browser?}
    F -->|No| G[Switch to Chrome, Firefox, or Edge]
    F -->|Yes| H{Are browser extensions interfering?}
    H -->|Maybe| I[Try incognito/private mode]
    H -->|No| J{Check internet connection}
    J -->|Slow/None| K[Check connection, try again]
    J -->|Good| L{Admin restrictions?}
    L -->|Possible| M[Contact Google Workspace admin]
    L -->|No| N[Clear cache and cookies, reinstall]

Solutions

Solution 1: Complete Installation

Problem: Installation never completed

Fix: Visit the Installation Guide and follow all steps.

---

Solution 2: Refresh Your Browser

Problem: Page needs refresh

Fix:

• Press Ctrl+R (Windows/Linux) or Cmd+R (Mac)
• Or click the refresh button
• Close and reopen Google Calendar

---

Solution 3: Try Different Browser

Problem: Browser compatibility issue

Fix:

• Recommended browsers: Chrome, Firefox, Edge
• Avoid: Very old browser versions, Internet Explorer
• Try Chrome if having issues with another browser

---

Solution 4: Disable Browser Extensions

Problem: Extension conflict

Fix:

1. Try opening in incognito/private mode (extensions are usually disabled)
2. If it works in incognito, a browser extension is interfering
3. Disable extensions one by one to find the culprit

---

Solution 5: Clear Cache and Cookies

Problem: Corrupted cache

Fix:

1. Clear browser cache and cookies
2. Logout of Google account
3. Log back in
4. Visit Notiwise installation link again

---

4. Settings Not Saving

Problem: Changes to settings aren’t being saved.

Diagnostic Flowchart

graph TD
    A[Settings not saving] --> B{Clicked Save Configuration?}
    B -->|No| C[Click Save after each step]
    B -->|Yes| D{Saw success message?}
    D -->|No| E{Any error message?}
    D -->|Yes| F[Settings saved - check event processing]
    E -->|Yes| G[Read error message - follow instructions]
    E -->|No| H{Internet connection stable?}
    H -->|No| I[Reconnect and try again]
    H -->|Yes| J[Try clearing settings and reconfiguring]

Solutions

Solution 1: Click Save Button

Problem: Changes not saved

Fix:

• After changing settings, always click “Save Configuration”
• For onboarding, click “Save All Settings” at the end
• Look for success confirmation message

---

Solution 2: Check for Error Messages

Problem: Save operation failed

Fix:

• Read any error messages carefully
• Common errors:
  • “Invalid time format” → Use 24-hour format (e.g., 08:00 not 8:00am)
  • “No calendars selected” → Select at least one calendar
  • “Duplicate tags” → Each tag must be unique

---

Solution 3: Verify Permissions

Problem: Lost script storage permission

Fix:

1. Go to myaccount.google.com
2. Navigate to Security → Third-party apps
3. Find “Notiwise”
4. Ensure permissions include “Script storage”
5. If not, re-authorize the app

---

5. Statistics Not Updating (NEW v2.1.0)

Problem: Dashboard statistics aren’t updating or show incorrect numbers.

Solutions

Solution 1: Process Events to Update Stats

Problem: Statistics update after event processing

Fix:

1. Click “Process Events Now” in dashboard
2. Statistics refresh after processing completes
3. Lifetime stats accumulate over time

---

Solution 2: Clear and Rebuild Statistics

Problem: Statistics are corrupted

Fix:

1. Open Notiwise settings
2. Look for “Clear All Settings” option
3. Warning: This resets all statistics
4. Reconfigure settings
5. Process events to rebuild statistics

---

Edge Cases & Special Situations

Edge Case 1: Tags in URLs

Problem: You have # or # in URLs and Notiwise is confused

Solution:

• Notiwise uses word boundary detection
• # in example.com#section is NOT recognized as a tag
• # at end like Meeting # IS recognized as a tag
• Tags must be standalone or at word boundaries

Examples:

• ✅ Meeting # (recognized)
• ✅ # Meeting (recognized)
• ❌ example.com#inbox (NOT recognized)
• ❌ Great! Meeting (exclamation is NOT ! tag)

---

Edge Case 2: All-Day Events

Problem: All-day events and reminder times

Solution:

• Notiwise works with all-day events!
• Reminders are set at configured times (morning, midday, afternoon)
• Example: Morning reminder = 7:30 AM on the reminder day

---

Edge Case 3: Multi-Day Events

Problem: Events spanning multiple days

Solution:

• Notiwise processes multi-day events normally
• Reminders are based on the start date of the event
• All reminders trigger before the event starts

---

Edge Case 4: Recurring Events

Problem: Weekly/monthly recurring events

Solution:

• Tag the first occurrence with a priority tag
• Notiwise processes each recurrence independently
• Future occurrences inherit reminders
• Or tag individual occurrences for different priorities

---

Edge Case 5: Events with Existing Reminders

Problem: Event already has manual reminders

Solution:

• Notiwise replaces existing reminders
• Manual reminders are removed, smart reminders added
• This ensures consistent reminder strategy

---

Getting Help

Still Having Issues?

If you’ve tried the solutions above and still need help:

Email Support: [email protected]

Please include:

1. Description: What’s happening vs what you expected
2. Steps to reproduce: How can we recreate the issue?
3. Screenshots: Visual evidence helps!
4. Browser: Which browser and version?
5. Account type: Personal Gmail or Google Workspace?
6. Error messages: Any errors you see?

Response time: Within 2-3 business days

---

Self-Help Resources

Before contacting support, try these resources:

• Quick Start Guide - 5-minute basics
• Getting Started Guide - Complete setup
• Features Documentation - How features work
• Installation Guide - Installation help

---

Prevention Tips

Avoid Common Issues

✅ DO:

• Use consistent tag placement (always start of title OR always end)
• Save settings after making changes
• Process events manually after bulk changes
• Keep tags simple (default tags work great!)
• Test with one event before bulk tagging

❌ DON’T:

• Mix tag locations randomly (confuses you and Notiwise)
• Assume settings auto-save (always click Save!)
• Tag past events (Notiwise ignores them)
• Use tags that appear in normal text (avoid common words)
• Add multiple tags to one event (only first is processed)

---

Still stuck? We’re here to help! Email [email protected]

---

Google Calendar™ and Google Workspace™ are trademarks of Google LLC.

Version: Notiwise v2.1.0

Support: [email protected]

• saas-software

• #help
• #notiwise
• #troubleshooting