[ Back to all articles ](https://addcal.co/blog.md) iphone apple calendar add to calendar troubleshooting Add to Calendar Link Not Working on iPhone? Why, and the Fix ============================================================ By Tom •September 30, 2026 You tap "Add to Calendar" on an iPhone and nothing happens. Or a file downloads and Calendar never opens. Or the page goes blank. The link is fine, the phone is fine, and the person is not doing anything wrong. In almost every case we see, the cause is the browser they are standing in, and it is not Safari. This post covers how to tell which browser you are in, why in-app browsers break add to calendar links on iOS, the fix for the person tapping, and the fix for the person sending the link. If you run events, the second half is the part that stops the support emails. The ten second check: are you in Safari? ---------------------------------------- Look at the top and bottom of the screen. Safari has an address bar you can type in and a tab button. An in-app browser has neither. It usually has the app's own header, a small "Done" or "X" in a corner, and a "..." menu that offers "Open in Safari" or "Open in browser". If that menu item exists, you are in an in-app browser, and that is why the link did nothing. Facebook, Messenger, Instagram and WhatsApp all do this on iPhone, and most other social apps do too. If the event link arrived through any of them, start there. Why the link fails inside apps ------------------------------ An add to calendar link for Apple Calendar is a small [.ics file](https://addcal.co/blog/what-is-an-icalendar-ics-file.md). In Safari, iOS recognises the file type, hands it to Calendar, and Calendar shows a preview with an Add button. That hand-off is the whole trick, and it depends on the browser knowing what to do with a file. Apple gives app developers two ways to show a web page. The first is [SFSafariViewController](https://developer.apple.com/documentation/safariservices/sfsafariviewcontroller), which Apple describes as a self-contained web interface that supports Safari features. It is Safari in a sheet. Files, downloads and the Calendar hand-off all work because it is the same engine with the same behaviour. The second is [WKWebView](https://developer.apple.com/documentation/webkit/wkwebview), a bare web view the app controls. It renders pages, but anything beyond rendering, including what happens when a page returns a file instead of HTML, is the app's job to implement. Most apps never write that code. So when the tap returns an .ics file, the web view has nowhere to send it and quietly drops it. Nothing on screen changes. Developers hit this constantly: the [react-native-webview issue tracker](https://github.com/react-native-community/react-native-webview/issues/768) has a years-old thread titled "Calendar file (.ics) download not working on iOS" where the report is exactly "when I click on the link nothing happens". Social apps use the second kind, because it lets them keep you inside the app and watch what you do. That is the entire cause. It is not a bug in the link, and there is nothing to fix in Settings. Some in-app browsers add a second problem: they rewrite the link before loading it, dropping or re-encoding parts of the query string. We have seen this on customer links, where the same link arrived intact from email and Safari and consistently damaged from a messaging app. If your link carries the event details in the URL rather than pointing at a hosted event page, pieces of it can go missing before the page even loads. The fix if you are the one tapping ---------------------------------- 1. Tap the "..." or share button, usually in a top corner. Choose **Open in Safari**. In WhatsApp the item reads **Open in browser**, and it opens whichever browser your phone uses by default. 2. Tap "Add to Calendar" again. Calendar opens a preview of the event. Tap **Add**, or **Add All** if there is more than one. 3. If a file downloaded instead of opening, go to the Files app, open Downloads, and tap the .ics file. Calendar previews it from there. This is not fully reliable: as one [unanswered Apple developer forum thread](https://developer.apple.com/forums/thread/711525) notes, iOS does not always associate a downloaded .ics with Calendar. If tapping the file does nothing, use step 1. Some links offer a "Subscribe" option instead of an add. That uses a [webcal:// address](https://addcal.co/blog/what-is-webcal-subscription-calendar-urls.md), which iOS hands to Calendar as a subscription rather than a download, so it works from inside apps. Tap Subscribe and the event appears in your calendar. It shows up as a subscribed calendar rather than an event you own, which you can remove later under Settings, Apps, Calendar, Accounts. The fix if you are the one sending the link ------------------------------------------- You cannot make Facebook's browser handle files. You can stop your link from depending on it. Four things, in order of how much they help. ### 1. Detect the in-app browser and say so Every in-app browser announces itself in the user agent string, and the major apps each carry an identifying token, so the page can tell it is not in Safari before the person taps anything. When you see one, do not fire the .ics download and hope. Show a short message that names the app and says its browser cannot add events directly, then offer the two options below. A person who understands why nothing happened will try again. A person who tapped a dead button will not. ### 2. Offer a subscription instead of a download A `webcal://` link is a URL scheme, not a file, so the operating system routes it to Calendar no matter which browser the tap came from. iOS asks the person to subscribe, they tap Subscribe, and the event is in their calendar. The trade-off is honest and worth stating on the page: it is a subscription, so it is read-only and Calendar will re-check it in the background. For a one-off event that is a fair price for a link that works. ### 3. Host the event page, do not put the details in the URL If the link is a long URL carrying the title, time and location as parameters, every app that rewrites links (WhatsApp, some email clients, most link shorteners) can damage it. A short link to a hosted event page survives all of them, and the page can then decide what to hand the phone. This is also what makes the link editable after you send it. ### 4. Test from inside the apps as well as Safari Send the link to yourself on WhatsApp, Instagram and Facebook Messenger and tap it on a real iPhone. Ten minutes, and it is the only test that catches this. If you build your own picker, put Apple Calendar first on iOS and Google first on Android, and hide "Outlook desktop" on phones entirely. That option hands a file to a desktop client that does not exist on a phone, and it is the second most common dead tap we see. Other iPhone causes, less common -------------------------------- - **Default calendar is not iCloud.** If the default calendar points at an account that is disabled or a third-party app, the add can fail without a message. Apple's path: [Settings, Apps, Calendar, Default Calendar](https://support.apple.com/en-us/102543), then choose a calendar under iCloud. On iOS 17 and earlier it is Settings, Calendar. - **Wrong target.** A "Google Calendar" link on an iPhone opens the Google Calendar website, which asks the person to sign in. If they use Apple Calendar, they will give up there. Offer Apple as an option; do not assume everyone with a Gmail address uses Google Calendar on their phone. - **Older iOS in Chrome or Firefox.** Third-party browsers on older iOS versions handled .ics downloads inconsistently. A subscription link works there too. - **Pop-up blocker.** Only relevant if your link opens a new tab. Safari's blocker lives under Settings, Apps, Safari. Better: do not open a new tab for an add. What AddCal does about it ------------------------- Every one of the four organiser fixes above is built into an [AddCal event link](https://addcal.co/solutions/add-to-calendar-links.md). The event page recognises in-app browsers, and when someone taps Apple Calendar from inside one it shows a sheet that names the app, explains that its browser cannot add events directly, and offers two choices: add the event as a subscription in one tap, or open the page in an external browser and add it as a single event. The picker is ordered for the phone in hand, with Apple first on iPhone and Google first on Android, and options that cannot work on a phone are not shown. You can make one for free, with no account, at the [add to calendar link generator](https://addcal.co/tools/add-to-calendar-link-generator.md). If you would rather see the Apple side of the flow first, [how to add an ICS file to iPhone](https://addcal.co/blog/how-to-add-an-ics-file-to-iphone-apple-calendar.md) walks through it from the recipient's seat. Last updated on September 30, 2026 ![Tom](https://cdn.addcal.co/static/authors/atymic.jpg)### Tom Founder Built Calndr.link in 2020 because an event link broke in Outlook and it annoyed him enough to fix it properly. Six years later he can tell you exactly how each calendar app mangles a timezone, which is a worse party trick than it sounds. Otherwise found hanging off a rock somewhere in Australia. [GitHub](https://github.com/atymic)[X](https://x.com/atymic) ### Related articles [How to Send a Calendar Invite on iPhone How to add invitees to an event in Apple Calendar on iOS, which accounts actually support invitations, why the Invitees row goes missing, and how to share an event when invites are not an option.](https://addcal.co/blog/how-to-send-a-calendar-invite-on-iphone.md)[How to Add an ICS File to iPhone and Apple Calendar Opening an ICS file on an iPhone is easy. Working out which calendar it landed in, or why it shows on the wrong day, is the hard part. A full guide to iOS, macOS, iCloud sync and subscribed calendars.](https://addcal.co/blog/how-to-add-an-ics-file-to-iphone-apple-calendar.md)[ICS Timezone Wrong in Google Calendar: Why Events Shift, and the Fix An imported .ics lands at the wrong time in Google Calendar for one of three reasons: a zone name Google does not know, a floating time read in your zone, or a bad daylight-saving rule. How to tell which, and the fix for each.](https://addcal.co/blog/ics-timezone-wrong-in-google-calendar.md) [ Browse all articles ](https://addcal.co/blog.md)