TabCalendar Troubleshooting
Last updated: February 23, 2026 (America/Los_Angeles)
Applies to version/build: TabCalendar Production (controlled access) docs baseline (updated February 19, 2026; see changelog)
This page is for operator triage: quick checks, clear boundaries, and what to send to support when you’re stuck.
If you haven’t already, skim Known Limitations. Some “bugs” are just boundaries doing their job.
Operator index
Before you escalate
- Confirm you’re in the correct HubSpot portal/account.
- Launch from a Company or Deal record tab (the record tab is the entry point).
- Note the record context (Company vs Deal) and whether the Deal has a Company association.
- Capture a timestamp with timezone and any visible error text.
Boundaries (quick reminders)
- The HubSpot record tab is a launcher; the calendar runs in hosted fullscreen.
- Workflow Action metadata exists, but the Workflow Action remains unpublished.
- Google Calendar is import-only (no bidirectional sync).
- ICS subscription feeds are optional and may be disabled by default.
Common signals and what to do
| Signal string / condition | What to do now |
|---|---|
| Install authorization fails | Re-run install authorization and confirm onboarding opens successfully. |
| Fullscreen calendar does not load after clicking Open TabCalendar | Confirm you launched from the TabCalendar record tab and retry from record context. |
| Fullscreen calendar redirects to HubSpot login | Complete the login prompt, then relaunch from the correct HubSpot account and portal. |
| Fullscreen calendar loads but data/actions show “unauthorized” / “session required” | Confirm you are logged into HubSpot and that cookies are enabled. Retry from the record tab and include a timestamp + portal ID in support intake. |
| Calendar does not resolve expected Company context on a Deal record | Confirm the Deal has a valid Company association and retry from record context. |
| Workflow action expected but unavailable | Workflow action remains deferred/unpublished in current scope. |
| ICS subscription feed not working | ICS is optional and may be disabled by default. If you don’t see a Subscribe/ICS option in fullscreen, treat it as unavailable. If you have a URL, treat it as a secret and escalate with a redacted example (never include full tokens). |
| Google import overlay not visible | Confirm Google connection and Company-to-calendar mapping, then rerun import/sync. |
| Status mapping produces unexpected labels | Confirm configured status set aligns to canonical values sold, held, unavailable. |
What to include in support intake
- Portal ID
- Record URL (Company or Deal)
- Expected behavior vs actual behavior
- Whether the issue is in status layers, day actions, multi-artist, Google import, or ICS
- Timestamp with timezone
- Screenshots (and sync/import evidence when relevant, with tokens redacted)
If escalation is needed, contact support with the above checklist.