Skip to content
Calendars & Appointments

Troubleshooting Tool for Calendar

Use the Share and Troubleshoot Calendar buttons in the calendar header to copy links, embed, preview, and run diagnostics—without leaving the editor.

6 min read1,241 words10 explained imagesUpdated Wed, 11 Feb at 2:51 AM
View as markdownOpen in ClaudeOpen in ChatGPT
Each image has a one line explanation. Switch to full detail for the step it belongs to, the fields and buttons involved, examples and the whole procedure.
On this page
  1. Key Benefits of the Troubleshooting Tool for Calendar
  2. How To Set Up and Use the Troubleshooting Tool for Calendar
  3. Accessing the Troubleshooting Tool
  4. Quick Access from Calendar Header
  5. Using the Tool to Diagnose Issues
  6. Additional Troubleshooting Tool Subtopics
  7. Checking Calendar Integration Status
  8. Resolve “Deleted Calendar” Connection Errors
  9. Troubleshooting User Availability Settings
  10. Common Booking Issues and What They Mean
  11. Diagnosing Double Booking Issues
  12. Understanding Permission-Related Errors
  13. Frequently Asked Questions
  14. Related Articles
  15. Important Notes

Troubleshooting Tool for Calendar lets users quickly identify and resolve calendar-related issues in GHL Customer Care, such as booking conflicts or missing availability. It provides visibility into common setup problems, helping users take immediate action to restore proper calendar functionality.


TABLE OF CONTENTS


Video 1 Open in a new tab


What is the Troubleshooting Tool for Calendar?

The Troubleshooting Tool for Calendar is a diagnostic feature within GHL Customer Care that helps users detect configuration issues that may prevent calendar appointments from being booked successfully. Misconfigured calendars can cause missed bookings, client frustration, and lost revenue. The Troubleshooting Tool for Calendar pinpoints exactly what’s wrong—like missing availability, user sync errors, or incorrect team settings—so users can fix the problem fast without needing to escalate support requests.


Key Benefits of the Troubleshooting Tool for Calendar

This feature provides instant clarity into calendar configuration issues, reducing guesswork and support delays. It empowers users to take control of their scheduling experience by identifying and resolving common booking blockers.

  • Instant Visibility: Detects common calendar setup issues in real-time, including availability gaps, unassigned users, or Google/Outlook sync failures.

  • Self-Service Diagnostics: Enables users to identify problems without needing to contact support.

  • Faster Booking Recovery: Quickly uncover the root cause of booking failures so calendars can resume normal function.

  • Multi-Calendar Support: Works with team and round-robin calendars, ensuring broad diagnostic coverage.

  • User Sync Insights: Highlights sync-related issues tied to individual users or their connected accounts.


How To Set Up and Use the Troubleshooting Tool for Calendar

This built-in tool doesn’t require setup, but knowing where to access it in the latest interface is essential to diagnose booking issues quickly and accurately.

Accessing the Troubleshooting Tool

Step 1: Navigate to Settings → Calendars in GHL Customer Care. At the top of the page, click Calendar Settings.

Accessing the Troubleshooting Tool (image 1 of 10) What this shows Step 1: Navigate to Settings → Calendars in GHL Customer Care. What this shows Illustrates the "Accessing the Troubleshooting Tool" section of "Troubleshooting Tool for Calendar". This screenshot appears in the "Accessing the Troubleshooting Tool" section of "Troubleshooting Tool for Calendar". The text alongside this image reads: Step 1: Navigate to Settings → Calendars in GHL Customer Care. At the top of the page, click Calendar Settings. Immediately after, the guide continues: Step 2: Locate the calendar you want to troubleshoot. Click the W rench Icon next to that calendar to open the tool. Image 1 of 10 What to clickStep 1: Navigate to Settings → Calendars in GHL Customer Care. At the top of the page, click Calendar Settings.
Buttons and menus referenced Settings → CalendarsWrench Icon
Next stepStep 2: Locate the calendar you want to troubleshoot. Click the W rench Icon next to that calendar to open the tool.

Step 2: Locate the calendar you want to troubleshoot. Click the Wrench Icon next to that calendar to open the tool.

Accessing the Troubleshooting Tool (image 2 of 10) What this shows Step 2: Locate the calendar you want to troubleshoot. What this shows Illustrates the "Accessing the Troubleshooting Tool" section of "Troubleshooting Tool for Calendar". This screenshot appears in the "Accessing the Troubleshooting Tool" section of "Troubleshooting Tool for Calendar". The text alongside this image reads: Step 2: Locate the calendar you want to troubleshoot. Click the W rench Icon next to that calendar to open the tool. Immediately after, the guide continues: Launching diagnostics from the calendar you’re editing reduces clicks and speeds up fixes. Image 2 of 10 What to clickStep 2: Locate the calendar you want to troubleshoot. Click the W rench Icon next to that calendar to open the tool.
Buttons and menus referenced Settings → CalendarsWrench Icon
Next stepLaunching diagnostics from the calendar you’re editing reduces clicks and speeds up fixes.

Quick Access from Calendar Header

Launching diagnostics from the calendar you’re editing reduces clicks and speeds up fixes.

Step 1

Open Settings → Calendars → [Your Calendar], then click Troubleshoot Calendar in the top-right header.

Quick Access from Calendar Header (image 3 of 10) What this shows Open Settings → Calendars → [Your Calendar], then click Troubleshoot Calendar in the top-right header. What this shows Illustrates the "Quick Access from Calendar Header" section of "Troubleshooting Tool for Calendar". This screenshot appears in the "Quick Access from Calendar Header" section of "Troubleshooting Tool for Calendar". The text alongside this image reads: Open Settings → Calendars → [Your Calendar], then click Troubleshoot Calendar in the top-right header. Immediately after, the guide continues: Click Troubleshoot Calendar to open diagnostics without leaving the editor. Image 3 of 10 Where to goOpen Settings → Calendars → [Your Calendar], then click Troubleshoot Calendar in the top-right header.
Buttons and menus referenced Step 1Settings → Calendars → [Your Calendar]Troubleshoot Calendartop-right header
Next stepClick Troubleshoot Calendar to open diagnostics without leaving the editor.

Click Troubleshoot Calendar to open diagnostics without leaving the editor.


Using the Tool to Diagnose Issues

Step 1: Select a date on the calendar grid.

Step 2: Hover over an unavailable time slot to view the reason in a tooltip.

Using the Tool to Diagnose Issues (image 4 of 10) What this shows Step 2: Hover over an unavailable time slot to view the reason in a tooltip. What this shows Illustrates the "Using the Tool to Diagnose Issues" section of "Troubleshooting Tool for Calendar". This screenshot appears in the "Using the Tool to Diagnose Issues" section of "Troubleshooting Tool for Calendar". The text alongside this image reads: Step 2: Hover over an unavailable time slot to view the reason in a tooltip. Immediately after, the guide continues: Beyond the basic tool overview, these additional subtopics dive into specific use cases and edge cases that frequently cause booking issues. Understanding how each of these scenarios works ensures you can proactively avoid disruptions and…. Image 4 of 10 What this coversStep 2: Hover over an unavailable time slot to view the reason in a tooltip. Next stepBeyond the basic tool overview, these additional subtopics dive into specific use cases and edge cases that frequently cause booking issues. Understanding how each of these scenarios works ensures you can proactively avoid disruptions and improve your scheduling reliability.

Additional Troubleshooting Tool Subtopics

Beyond the basic tool overview, these additional subtopics dive into specific use cases and edge cases that frequently cause booking issues. Understanding how each of these scenarios works ensures you can proactively avoid disruptions and improve your scheduling reliability.

Checking Calendar Integration Status

Proper calendar integration is the foundation for accurate syncing and availability. If your calendar isn’t connected correctly, appointments may fail to appear or sync incorrectly.

  1. Go to Calendar Settings > Connections.

  2. Confirm Google or Outlook is marked "Connected".

  3. Reconnect if needed and select the correct calendar.

Checking Calendar Integration Status (image 5 of 10) What this shows Go to Calendar Settings > Connections. What this shows Illustrates the "Checking Calendar Integration Status" section of "Troubleshooting Tool for Calendar". This screenshot appears in the "Checking Calendar Integration Status" section of "Troubleshooting Tool for Calendar". The text alongside this image reads: Go to Calendar Settings > Connections. Confirm Google or Outlook is marked "Connected". Reconnect if needed and select the correct calendar. The navigation path used here is Calendar Settings > Connections. Immediately after, the guide continues: If a connected Google/Outlook calendar was deleted at the provider, GHL Customer Care may show an error banner. You can now clean this up without contacting Support. Path: Calendar Settings > ConnectionsImage 5 of 10 Where to goGo to Calendar Settings > Connections. Confirm Google or Outlook is marked "Connected". Reconnect if needed and select the correct calendar. Next stepIf a connected Google/Outlook calendar was deleted at the provider, GHL Customer Care may show an error banner. You can now clean this up without contacting Support.

Resolve “Deleted Calendar” Connection Errors 

If a connected Google/Outlook calendar was deleted at the provider, GHL Customer Care may show an error banner. You can now clean this up without contacting Support.

  1. In Settings of your account, navigate to the Calendars section and click on Connections tab.

  2. Click Fix This.

    Step 2 of 5: Click Fix This What this shows Step 2 of 5: Click Fix This. What this shows Shows what to click for step 2 of 5 in the "Resolve “Deleted Calendar” Connection Errors" section of "Troubleshooting Tool for Calendar". This screenshot accompanies step 2 of 5 in the "Resolve “Deleted Calendar” Connection Errors" section of "Troubleshooting Tool for Calendar". At this point in the walkthrough you click Fix This. For context, this section explains: If a connected Google/Outlook calendar was deleted at the provider, GHL Customer Care may show an error banner. You can now clean this up without contacting Support. The next step is to review the modal list of deleted calendars. Step 2 of 5Image 6 of 10 What to clickClick Fix This.
    Buttons and menus referenced Fix ThisSettingsCalendarsConnectionsRemove Deleted Calendars
    Next stepReview the modal list of deleted calendars:
    All 5 steps in this procedure
    1. In Settings of your account, navigate to the Calendars section and click on Connections tab.
    2. Click Fix This. this image
    3. Review the modal list of deleted calendars:
    4. Click Remove Deleted Calendars to remove the broken calendar connections in one action.
    5. Reconnect or reselect a valid calendar if needed.
  3. Review the modal list of deleted calendars:

    • Each item shows the deleted calendar and where it’s connected in GHL Customer Care.

  4. Click Remove Deleted Calendars to remove the broken calendar connections in one action. 

    Step 4 of 5: Click Remove Deleted Calendars to remove the broken calendar… What this shows Step 4 of 5: Click Remove Deleted Calendars to remove the broken calendar connections in one action. What this shows Shows what to click for step 4 of 5 in the "Resolve “Deleted Calendar” Connection Errors" section of "Troubleshooting Tool for Calendar". This screenshot accompanies step 4 of 5 in the "Resolve “Deleted Calendar” Connection Errors" section of "Troubleshooting Tool for Calendar". At this point in the walkthrough you click Remove Deleted Calendars to remove the broken calendar connections in one action. The next step is to reconnect or reselect a valid calendar if needed. Step 4 of 5Image 7 of 10 What to clickClick Remove Deleted Calendars to remove the broken calendar connections in one action.
    Buttons and menus referenced Remove Deleted CalendarsSettingsCalendarsConnectionsFix This
    Next stepReconnect or reselect a valid calendar if needed.
    All 5 steps in this procedure
    1. In Settings of your account, navigate to the Calendars section and click on Connections tab.
    2. Click Fix This.
    3. Review the modal list of deleted calendars:
    4. Click Remove Deleted Calendars to remove the broken calendar connections in one action. this image
    5. Reconnect or reselect a valid calendar if needed.
  5. Reconnect or reselect a valid calendar if needed.

Learn More: Google Calendar Integration Setup

Troubleshooting User Availability Settings

Even if the calendar is integrated, missing or incorrect availability blocks bookings. The Troubleshooting Tool will flag users without defined working hours. To review and adjust availability:

  1. Go to Calendars > Calendar Settings.

  2. Find the calendar assigned to the user and click Edit.

  3. Click the Availability tab inside that calendar.

  4. Add or edit the available time blocks for relevant days.

Troubleshooting User Availability Settings (image 8 of 10) What this shows Go to Calendars > Calendar Settings. What this shows Illustrates the "Troubleshooting User Availability Settings" section of "Troubleshooting Tool for Calendar". This screenshot appears in the "Troubleshooting User Availability Settings" section of "Troubleshooting Tool for Calendar". The text alongside this image reads: Go to Calendars > Calendar Settings. Find the calendar assigned to the user and click Edit. Click the Availability tab inside that calendar. Add or edit the available time blocks for relevant days. The navigation path used here is Calendars > Calendar Settings. Immediately after, the guide continues: Learn More: How to Set Up Availability for Calendar Users. Path: Calendars > Calendar SettingsImage 8 of 10 Where to goGo to Calendars > Calendar Settings. Find the calendar assigned to the user and click Edit. Click the Availability tab inside that calendar. Add or edit the available time blocks for relevant days.
Buttons and menus referenced Calendars > Calendar SettingsEditAvailability
Next stepLearn More: How to Set Up Availability for Calendar Users
All 4 steps in this procedure
  1. Go to Calendars > Calendar Settings.
  2. Find the calendar assigned to the user and click Edit.
  3. Click the Availability tab inside that calendar.
  4. Add or edit the available time blocks for relevant days.
Learn More: How to Set Up Availability for Calendar Users

Common Booking Issues and What They Mean

Each status code shown in the Troubleshooting Tool tooltip reveals the reason a time slot is not bookable.

  • USER: No available users at this time

  • COLLECTIVE: One or more users are unavailable

  • CONFLICT: Third-party calendar conflict

  • BOOKED: Already booked via the system

  • BLOCKED: Manually blocked time

  • NOTICE: Violates minimum scheduling notice

  • TOOFAR: Beyond allowed date range

  • DAYLIMIT: Day's appointment limit reached

  • SLOTMAX: Max bookings for the slot reached

  • BUFFER: Buffer time blocks this slot

  • DURATION: Appointment too long for gap

  • PAST: Time is in the past

  • LOOKBUSY: Hidden via Look Busy setting

  • NO SEATS: Max seats reached

  • RESOURCE: Required resource is unavailable


Diagnosing Double Booking Issues

Double bookings can happen when multiple users are synced to the same calendar or if availability overlaps.

  • Use the Troubleshooting Tool to identify which users are in conflict.

  • Adjust user calendars or isolate calendars per user to avoid overlaps.

Learn More: Troubleshoot Double Bookings

Sometimes booking issues occur due to revoked permissions or missing access scopes in Google/Outlook.

  • Go to Settings > My Staff

  • Find Staff Member then select Edit> Calendar Configuration.

  • Click Calendar on left ribbon then confirm all required permission scopes are granted.

Understanding Permission-Related Errors (image 9 of 10) What this shows Go to Settings > My Staff Find Staff Member then select Edit > Calendar Configuration. What this shows Illustrates the "Understanding Permission-Related Errors" section of "Troubleshooting Tool for Calendar". This screenshot appears in the "Understanding Permission-Related Errors" section of "Troubleshooting Tool for Calendar". The text alongside this image reads: Go to Settings > My Staff Find Staff Member then select Edit > Calendar Configuration. Click Calendar on left ribbon then confirm all required permission scopes are granted. The navigation path used here is Settings > My Staff Find Staff Member. Immediately after, the guide continues: Learn More: User Permissions in Calendars. Path: Settings > My Staff Find Staff MemberImage 9 of 10 Where to goGo to Settings > My Staff Find Staff Member then select Edit > Calendar Configuration. Click Calendar on left ribbon then confirm all required permission scopes are granted.
Buttons and menus referenced Settings > My StaffEdit> Calendar ConfigurationCalendar
Next stepLearn More: User Permissions in Calendars
All 3 steps in this procedure
  1. Go to Settings > My Staff
  2. Find Staff Member then select Edit > Calendar Configuration.
  3. Click Calendar on left ribbon then confirm all required permission scopes are granted.
Understanding Permission-Related Errors (image 10 of 10) What this shows Go to Settings > My Staff Find Staff Member then select Edit > Calendar Configuration. What this shows Illustrates the "Understanding Permission-Related Errors" section of "Troubleshooting Tool for Calendar". This screenshot appears in the "Understanding Permission-Related Errors" section of "Troubleshooting Tool for Calendar". The text alongside this image reads: Go to Settings > My Staff Find Staff Member then select Edit > Calendar Configuration. Click Calendar on left ribbon then confirm all required permission scopes are granted. The navigation path used here is Settings > My Staff Find Staff Member. Immediately after, the guide continues: Learn More: User Permissions in Calendars. Path: Settings > My Staff Find Staff MemberImage 10 of 10 Where to goGo to Settings > My Staff Find Staff Member then select Edit > Calendar Configuration. Click Calendar on left ribbon then confirm all required permission scopes are granted.
Buttons and menus referenced Settings > My StaffEdit> Calendar ConfigurationCalendar
Next stepLearn More: User Permissions in Calendars
All 3 steps in this procedure
  1. Go to Settings > My Staff
  2. Find Staff Member then select Edit > Calendar Configuration.
  3. Click Calendar on left ribbon then confirm all required permission scopes are granted.
Learn More: User Permissions in Calendars

Frequently Asked Questions

Q: Do I need to enable the Troubleshooting Tool separately?
No. The Troubleshooting Tool is built into the platform and automatically available under Calendar Settings.

Q: Why is a time slot showing as “UNAVAILABLE”?
This means the user is outside their availability or the time is blocked by a conflict such as another event, sync issue, or booking restriction.

Q: Why does my calendar show no available times at all?
This usually occurs when no user is assigned, no availability is set, or calendar sync is disconnected,

Q: Can I use this tool to debug group or round-robin calendars?
Yes. It supports group calendars and shows which users are causing booking failures.

Q: Does the Troubleshooting Tool show automation or workflow errors?
No. It only surfaces calendar-specific setup issues—not automation logic.

Q: Can I view availability from the contact’s timezone in this tool?
No. The view is based on the logged-in user's timezone.



Important Notes

  • The tool first checks your calendar’s availability and meeting intervals to generate all potential slots. It then shows which of these slots are available and which are not.
  • For example, if your calendar availability is set from 10 AM to 12 PM and 6 PM to 8 PM with 60-minute meeting intervals, only the 10 AM, 11 AM, 6 PM, and 7 PM slots will be displayed, and their availability or unavailability will be shown accordingly for these four slots. If the calendar is unavailable on Saturdays, no slots will appear for that day.

Was this guide helpful?

Related guides