Knowledgebase

Common Issues and Solutions

My tooltip isn't appearing

Check these items:

1. Is the tooltip Active?
   • Go to Components → Monthly Calendar → Manage Tooltips
   • Find your tooltip in the list
   • Check if it shows as Active
   • If not, edit it and turn on the Active toggle
2. Did you rebuild the cache?
   • Go to Components → Monthly Calendar → Rebuild Tooltip Cache
   • Set the date range to include the date you're testing
   • Click "Rebuild Tooltip Cache"
   • Wait for the process to complete
3. Does the term actually appear in your calendar?
   • View the calendar day you're testing
   • Check if the exact term from your include list appears in the text
   • Check spelling and capitalization (though matching is case-insensitive)
4. Check your include terms list:
   • Edit the tooltip
   • Look at the "Include terms" field
   • Make sure the term is spelled correctly
   • Make sure there are no extra spaces before or after the term
   • Make sure you pressed Enter after each term to put them on separate lines
5. Is the date in your rebuild range?
   • If you only rebuilt October-December but you're testing a January date, you need to rebuild January too

Tooltip appears but shows wrong information

Solutions:

1. Edit the tooltip:
   • Go to Components → Monthly Calendar → Manage Tooltips
   • Click Edit next to the tooltip
   • Update the Title, Description, or Image
   • Click Save
   • Rebuild the cache
2. Check if multiple tooltips match the same term:
   • Two tooltips might have the same include term
   • The one with higher Priority will be used
   • Consider editing or deactivating one of them

Tooltip appears in the wrong place

Solution:

• Edit the tooltip
• Change the Category to "General" (this makes it appear everywhere)
• Save and rebuild the cache

Most tooltips should use "General" category unless you specifically want to limit where they appear.

The same term triggers two different tooltips

Why this happens:

• You have two active tooltips with the same include term
• The system will choose one based on Priority

Solutions:

1. Different tooltips for different contexts:
   • Keep both tooltips active but use exclude terms to control where each appears
   • Example: "Pentecost" tooltip excludes "Sunday after" so it won't appear on "Sunday after Pentecost"
2. Remove the duplicate term:
   • Edit one of the tooltips
   • Remove the term from the include list
   • Save and rebuild
3. Use Priority:
   • Edit the tooltip you want to take precedence
   • Set its Priority to a higher number (like 5 or 10)
   • The other can stay at 0
   • Save and rebuild

Changes I made aren't showing up

Steps to fix:

1. Always rebuild after making changes:
   • Go to Components → Monthly Calendar → Rebuild Tooltip Cache
   • Make sure your date range includes the dates you changed
   • Click "Rebuild Tooltip Cache"
2. Clear your browser cache:
   • Press Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)
   • Or try viewing in a private/incognito window
3. Check that you saved:
   • Go back to the tooltip editor
   • Verify your changes are there
   • If not, make the changes again and click Save

Term with multiple words isn't matching

Example: You added "Divine Liturgy" but it's not being linked.

Check:

• Make sure the term is on its own line in the include terms field
• Make sure there are no extra line breaks within the term
• The exact phrase "Divine Liturgy" must appear in your calendar text
• Multi-word terms only match the exact phrase, not the individual words

Try this:

• Edit the tooltip
• In include terms, add both:

  Divine Liturgy
  Liturgy

• This way "Liturgy" by itself will also match
• Save and rebuild

Tooltip keeps matching the wrong instances

Example: A "Cross" tooltip is matching the word "across" or "crossroads"

Solution - Use Exclude Terms:

1. Edit the tooltip
2. In the "Exclude terms" field, add:

   across
   crossroads

3. Save and rebuild
4. Now the tooltip won't appear when these exclude terms are found near the include term

Image isn't showing in the tooltip

Check:

1. Edit the tooltip
2. Look at the Featured Image section
3. Is an image actually selected?
4. Try uploading a different image
5. Make sure the image file is not too large (under 100KB recommended)
6. Save and rebuild the cache

Tooltip popup looks strange or doesn't open

Try:

1. Refresh the page (F5)
2. Clear your browser cache (Ctrl+F5)
3. Try a different browser
4. Try on a different device

If the problem persists on all browsers and devices, contact support.

Quick Troubleshooting Checklist

When a tooltip isn't working, go through this checklist:

• Tooltip is marked as Active
• Include terms are spelled correctly
• Each term is on its own line
• Cache has been rebuilt
• Rebuild date range includes the date you're testing
• The exact term appears in your calendar text
• No exclude terms are blocking the match
• Browser cache has been cleared

Getting Help

If you've tried all the solutions above and your tooltip still isn't working:

1. Note exactly what's happening (or not happening)
2. Note which tooltip you're working with (the title)
3. Note which calendar date you're testing
4. Take a screenshot if helpful
5. Contact support with this information