> For the complete documentation index, see [llms.txt](https://digital-builders.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://digital-builders.gitbook.io/docs/integrations/google-calendar.md).

# Connecting Your Calendar

Connect your calendar so clients can never book a time you're already busy. You also get a private calendar feed showing your coaching bookings.

## Two Directions, Two Different Things

**Inbound (busy time in).** Digital Builders reads when you're busy so those times aren't offered to clients.

**Outbound (bookings out).** You get a private feed link you can add to any calendar app so your coaching sessions appear there.

You can use one without the other.

## Connect Your Calendar

1. Go to **Admin → Coaching**
2. Open the **Availability** tab
3. Find the calendar section
4. Click connect and choose **Google Calendar**
5. Sign in to Google and approve access
6. You'll be sent back to the app with a confirmation

### What Gets Shared, and What Doesn't

This matters more than anything else on this page:

* Digital Builders reads **only whether you're busy at a given time**
* Event **titles, descriptions, guests, and locations are not read or stored**
* Clients never see what's on your calendar, only the free times you offer

> **Note:** Approve **all** the permissions Google asks for. If ongoing access isn't granted, the connection stalls shortly after it's made and you'll be asked to reconnect.

## How Many Calendars

You can connect more than one calendar — a work calendar and a personal one, for example.

| Plan              | Calendars you can connect |
| ----------------- | ------------------------- |
| Free              | 1                         |
| Starter and above | Up to 10                  |

If you hit the limit, the app offers an upgrade instead of a broken button.

## Connection Statuses

| Status              | Meaning                                | What to do                            |
| ------------------- | -------------------------------------- | ------------------------------------- |
| **Active**          | Working; busy time is being blocked    | Nothing                               |
| **Needs attention** | Access lapsed or was partially granted | Reconnect and approve all permissions |
| **Revoked**         | Access was removed, here or in Google  | Reconnect                             |

Disconnecting a calendar stops blocking that calendar's busy time straight away. Sessions already booked are untouched.

## How Fresh the Data Is

Availability is checked when a client looks at your times, so busy time is usually current to within a few minutes. A background sync also runs hourly and looks about 60 days ahead.

> **Tip:** If you add a meeting to your calendar and immediately check your booking page, give it a few minutes. Very recent events can briefly still appear bookable.

## The Outbound Feed

To see your coaching bookings in your own calendar:

1. In the same calendar section, choose to generate a feed
2. Copy the private link it gives you
3. Add it to your calendar app as a subscribed calendar
4. Refresh the app — new bookings appear from then on

The feed includes everything from the last two weeks plus all future bookings.

### What Appears in the Feed

Each booking shows as **Busy** — nothing else.

* No client names
* No session titles
* No descriptions or notes

That's deliberate: the link is a URL, and anyone who has it can read the feed. Keeping it to "busy" means a leaked link reveals nothing about your clients.

> **CRITICAL:** Treat the feed link like a password. If you think it's been shared, regenerate it — the old link stops working immediately, and you'll need to re-add the new one to your calendar app.

## Common Questions

**I connected my calendar but a slot still shows.** Check the event is on a calendar you actually connected, and give the sync a few minutes.

**Will clients see my event titles?** No. Only free and busy times are ever used.

**Does this book into my calendar?** No. The feed shows your coaching bookings, but the booking itself lives in the app.

**Can I use Outlook or Apple Calendar?** The connection is for Google Calendar. Other calendars can subscribe to the outbound feed, which is how most people see bookings in Outlook or Apple Calendar.

**What happens if I revoke access in Google?** The connection shows **Revoked**, and busy time stops being blocked. Reconnect to fix it.

## Next Steps

* [Set your availability](https://digital-builders.gitbook.io/docs/coaching/availability.md)
* [Zoom integration](https://digital-builders.gitbook.io/docs/integrations/zoom.md)
* [Integrations overview](https://digital-builders.gitbook.io/docs/integrations/overview.md)
