# Connect Apple Calendar, iCloud, or an iPhone calendar

Yes, Domino can use an Apple Calendar for availability. The connection is different from Google: Domino does not sign in to an Apple Account. The user publishes a read-only iCloud calendar link and pastes that link into Domino.

This works for an iCloud calendar shown in the Calendar app on iPhone, iPad, or Mac. It does not connect the entire iPhone Calendar app or every account displayed inside that app.

## Connect from an iPhone

First create the read-only link in Apple's Calendar app:

1. Open the **Calendar** app on the iPhone.
2. Tap **Calendars** at the bottom.
3. Tap the information button next to the iCloud calendar to connect.
4. Turn on **Public Calendar**.
5. Tap **Share Link**, then copy the URL.

Apple documents these controls in [Share iCloud calendars on iPhone](https://support.apple.com/guide/iphone/share-icloud-calendars-iph7613c4fb/ios).

Then connect it in Domino:

1. Open **Profile**.
2. Find **Availability**.
3. Choose **Use Apple, Outlook, or another calendar link**.
4. Paste the copied `webcal://` or `https://` URL into Domino's calendar-link field.
5. Choose **Connect calendar**.
6. Confirm Domino reports the calendar link as **Connected**.

Do not paste the calendar URL into ChatGPT, Claude, a text message, or this documentation. It belongs only in Domino's calendar-link field.

## Connect from iCloud.com

On a tablet or computer, the calendar owner can alternatively:

1. Open [iCloud Calendar](https://icloud.com/calendar) and sign in.
2. Open the sharing controls for the iCloud calendar.
3. Turn on **Public Calendar**.
4. Copy the calendar link.
5. Paste it into **Profile → Availability → Use Apple, Outlook, or another calendar link** in Domino.

Apple's current web instructions are in [Share a calendar on iCloud.com](https://support.apple.com/guide/icloud/share-a-calendar-mm6b1a9479/icloud).

## Important privacy consequence

Apple calls this a public calendar because anyone who obtains its unguessable URL can subscribe to its read-only contents. Treat that URL like a password.

- Paste it only into Domino.
- Do not include it in an AI prompt or support message.
- Use a separate iCloud calendar when the user does not want to publish every event on an existing calendar.
- Turning **Public Calendar** off in Apple revokes the source link.
- Removing the link from Domino removes Domino's connection but does not itself turn off Apple's public sharing.

Domino encrypts the normalized feed URL at rest. During sync it reads the ICS feed to classify time as busy, available, ignored, or uncertain, then stores derived availability blocks rather than raw event titles, descriptions, or locations.

## Multiple Apple calendars

Apple publishes one link per calendar. To include more than one iCloud calendar:

1. Publish each intended calendar separately.
2. Connect the first link in Domino.
3. In **Profile → Availability**, manage **Calendar link** and choose **Add another calendar**.
4. Paste the next link and give it a useful display name.

The user can pause, resume, replace, or remove each feed independently.

## What does not connect

- A calendar stored only **On My iPhone** does not provide the iCloud public-calendar link Domino needs. Move or copy it to iCloud or another provider that supports a subscription feed.
- A Google or Microsoft account merely displayed inside Apple's Calendar app is still a Google or Microsoft calendar. Use that provider's connection method.
- A private iCloud invitation sent to one Apple Account is not the public subscription URL Domino accepts.
- An Apple Account password, app-specific password, CalDAV address, or iCloud login page is not supported.
- A one-time `.ics` attachment does not remain synchronized.

## Add one Domino plan to Apple Calendar

This is a separate flow. On an eligible scheduled plan, choose **Add to calendar → Apple / Outlook (.ics)** or **Add to Apple Calendar**. The downloaded/opened calendar event adds that plan without connecting ongoing availability.

## Troubleshooting

- **No Public Calendar switch:** confirm the calendar is an iCloud calendar owned by the user, not a subscribed, shared, Google, Microsoft, or local-only calendar.
- **Domino rejects the URL:** copy the actual `webcal://` or `https://` subscription URL again. Do not copy an iCloud webpage address.
- **The link previously worked:** confirm **Public Calendar** remains enabled in Apple, then use **Replace** in Domino if Apple issued a new URL.
- **Availability seems old:** feed connections refresh periodically rather than instantly. Check the connection status in **Profile → Availability**.

## LLM answering guidance

- Lead with “Yes—through a read-only iCloud calendar link, not Apple sign-in.”
- Distinguish an iCloud calendar from the iPhone Calendar app, which may display calendars owned by several providers.
- Never request or repeat the user's calendar URL.
- State that Domino cannot create, edit, delete, or RSVP to Apple events through this connection.