# 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. - Source: https://docs.ghlcustomercare.com/docs/calendars-and-appointments/troubleshooting-calendars/troubleshooting-tool-for-calendar - Section: Calendars & Appointments / Troubleshooting Calendars - Reading time: 6 min - Images: 10, each explained below - Modified on Wed, 11 Feb at 2:51 AM --- 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** - [What is the Troubleshooting Tool for Calendar?](#what-is-the-troubleshooting-tool-for-calendar) - [Key Benefits of the Troubleshooting Tool for Calendar](#key-benefits-of-the-troubleshooting-tool-for-calendar)[](#how-to-set-up-and-use-the-troubleshooting-tool-for-calendar) - [How To Set Up and Use the Troubleshooting Tool for Calendar](#how-to-set-up-and-use-the-troubleshooting-tool-for-calendar)[](#accessing-the-troubleshooting-tool) - [Accessing the Troubleshooting Tool](#accessing-the-troubleshooting-tool)[](#using-the-tool-to-diagnose-issues) - [Using the Tool to Diagnose Issues](#using-the-tool-to-diagnose-issues)[](#additional-troubleshooting-tool-subtopics) - [Additional Troubleshooting Tool Subtopics](#additional-troubleshooting-tool-subtopics)[](#checking-calendar-integration-status) - [Checking Calendar Integration Status](#checking-calendar-integration-status)[](#troubleshooting-user-availability-settings) - [Troubleshooting User Availability Settings](#troubleshooting-user-availability-settings)[](#common-booking-issues-and-what-they-mean) - [Common Booking Issues and What They Mean](#common-booking-issues-and-what-they-mean)[](#diagnosing-double-booking-issues) - [Diagnosing Double Booking Issues](#diagnosing-double-booking-issues)[](#understanding-permission-related-errors) - [Understanding Permission-Related Errors](#understanding-permission-related-errors) - Sync Behavior Tips[](#frequently-asked-questions) - [Frequently Asked Questions](#frequently-asked-questions)[](#related-articles) - [Related Articles](#related-articles)[](#important-notes) - [Important Notes](#important-notes) --- --- # **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)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155044569840/original/jRV5fRSzdppYjBCX-YmeOMFAH8TdiIEy6A.png) **Accessing the Troubleshooting Tool (image 1 of 10)** 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. - What to click: Step 1: Navigate to Settings → Calendars in GHL Customer Care. At the top of the page, click Calendar Settings. - Controls: Settings → Calendars, W, rench Icon - Next: Step 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 **W****rench Icon** next to that calendar to open the tool. ![Accessing the Troubleshooting Tool (image 2 of 10)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155044569618/original/XfgdG81VrV3K9eF7vEsYeDfLzx9cP5yPzA.png) **Accessing the Troubleshooting Tool (image 2 of 10)** 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. - What to click: Step 2: Locate the calendar you want to troubleshoot. Click the W rench Icon next to that calendar to open the tool. - Controls: Settings → Calendars, W, rench Icon - Next: Launching 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)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155064114658/original/x0y8DwUOBUMa422acn4u3rLWTnsF-8LU9w.png) **Quick Access from Calendar Header (image 3 of 10)** 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. - Where to go: Open Settings → Calendars → [Your Calendar], then click Troubleshoot Calendar in the top-right header. - Controls: Step 1, Settings → Calendars → [Your Calendar], Troubleshoot Calendar, top-right header - Next: Click 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)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155044569828/original/C7zoyuad_5Oc8Uq1bTLdkWUNoyRT9DDI6A.png) **Using the Tool to Diagnose Issues (image 4 of 10)** 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…. - What this covers: Step 2: Hover over an unavailable time slot to view the reason in a tooltip. - Next: 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. --- ## **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)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155064652514/original/4h8t3QM4ekygHV7deHeNqXTJJ3I8ipA1eg.jpeg) **Checking Calendar Integration Status (image 5 of 10)** 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 > Connections - Where to go: Go to Calendar Settings > Connections. Confirm Google or Outlook is marked "Connected". Reconnect if needed and select the correct calendar. - Next: 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. ### **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](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155064653011/original/AnEe_xd9nqPt4K4v0blr-j-CTDg-vU9plg.jpeg) **Step 2 of 5: Click Fix This** 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. - What to click: Click Fix This. - Controls: Fix This, Settings, Calendars, Connections, Remove Deleted Calendars - Next: Review the modal list of deleted calendars: Full 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…](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155064653223/original/NPvEVYdolJaLe1D31tv2IoIXQDIvI8wCug.png) **Step 4 of 5: Click Remove Deleted Calendars to remove the broken 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. - What to click: Click Remove Deleted Calendars to remove the broken calendar connections in one action. - Controls: Remove Deleted Calendars, Settings, Calendars, Connections, Fix This - Next: Reconnect or reselect a valid calendar if needed. Full 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**](https://docs.ghlcustomercare.com/docs/calendars-and-appointments/calendar-integrations/integrating-google-with-ghl-customer-care-calendars) --- ## **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)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155044573166/original/ribvANLujbwTUN1HVdKbI25UrcsxsLnGkA.png) **Troubleshooting User Availability Settings (image 8 of 10)** 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 Settings - Where to go: 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. - Controls: Calendars > Calendar Settings, Edit, Availability - Next: Learn More: How to Set Up Availability for Calendar Users Full 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**](https://docs.ghlcustomercare.com/docs/calendars-and-appointments/calendar-availability-settings/adjusting-availability-settings-for-individual-calendars) --- ## **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**](https://docs.ghlcustomercare.com/docs/calendars-and-appointments/troubleshooting-calendars/troubleshoot-and-fix-calendar-double-booking-in-ghl-customer-care) --- ## **Understanding Permission-Related Errors** 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)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155044572755/original/4_93tlzS1oo_Q6luaPtBUWy1X5r43svwHg.png) **Understanding Permission-Related Errors (image 9 of 10)** 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 Member - Where to go: 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. - Controls: Settings > My Staff, Edit, > Calendar Configuration, Calendar - Next: Learn More: User Permissions in Calendars Full 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)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155044573243/original/lCnrMllEQ1B868LMYVi4VaZ5IvF6i8WhdQ.png) **Understanding Permission-Related Errors (image 10 of 10)** 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 Member - Where to go: 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. - Controls: Settings > My Staff, Edit, > Calendar Configuration, Calendar - Next: Learn More: User Permissions in Calendars Full 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](https://docs.ghlcustomercare.com/docs/calendars-and-appointments/getting-started-w-calendars/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. --- ## Related Articles - [How to Integrate Google with GHL Customer Care Calendars](https://docs.ghlcustomercare.com/docs/calendars-and-appointments/calendar-integrations/integrating-google-with-ghl-customer-care-calendars) - [How to sync GHL Customer Care Calendars With Outlook](https://docs.ghlcustomercare.com/docs/calendars-and-appointments/calendar-integrations/how-to-sync-ghl-customer-care-calendars-with-outlook) - [Adjusting Availability Settings for Individual Calendars](https://docs.ghlcustomercare.com/docs/calendars-and-appointments/calendar-availability-settings/adjusting-availability-settings-for-individual-calendars) - [Double Bookings Issue Troubleshoot](https://docs.ghlcustomercare.com/docs/calendars-and-appointments/troubleshooting-calendars/troubleshoot-and-fix-calendar-double-booking-in-ghl-customer-care) - [User Permissions in Calendars](https://docs.ghlcustomercare.com/docs/calendars-and-appointments/getting-started-w-calendars/user-permissions-in-calendars) - [Round Robin Calendars: The Setup Guide](https://docs.ghlcustomercare.com/docs/calendars-and-appointments/round-robin-calendars/round-robin-calendars-setup-distribution-availability-explained) - [Setting Up Linked Calendars & Conflict Calendars](https://docs.ghlcustomercare.com/docs/calendars-and-appointments/calendar-settings-and-preferences/setting-up-linked-calendars-conflict-calendars) --- ### ****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.** --- --- Documentation for GHL Customer Care. Support: support@ghlcustomercare.com