Skip to content
Blink Brief
Language:

Guide · Office and email

How to open an .ics attachment in the Gmail app and add it to your calendar (iPhone and Android)

By Blink Brief · Updated  · How pages are made

To open an .ics attachment from the Gmail app on an iPhone or Android phone, save the attachment, then open it in the free ICS viewer in the phone's browser: tap Choose an .ics file and pick the file, and every event is listed with its date, time and place. Tap Add to Google Calendar or Add to Outlook on each event you want. Gmail itself only answers invitations: it shows Yes, No or Maybe at the top of an invitation email, and Google's help gives no step for adding a plain .ics attachment from the app. The Google Calendar app can't import an .ics file either; Google's help sends you to a computer.

Short answer

  • An invitation (Yes, No, Maybe at the top): tap your answer in Gmail. Nothing to download.
  • A plain .ics file, on a phone: download it, then ICS viewer › Choose an .ics file › Add to Google Calendar or Add to Outlook on each event.
  • A plain .ics file, many events: download it on a computer and import it once: Google Calendar › Settings › Import & Export.

The quickest way on any phone: download it, open it in the ICS viewer

The viewer is a web page, so it runs in Chrome on Android and in Safari on an iPhone, with nothing to install and no sign-up.

  1. Save the attachment to the phone. On Android, Google's steps are: open the email in the Gmail app and tap Download. On an iPhone, see the iPhone section below.
  2. Open the ICS viewer in the phone's browser and tap Choose an .ics file. Pick the file, usually in Downloads.
  3. Read the list. Each event shows its title, date and time, time zone, how it repeats, place and notes. When the event's time zone isn't the phone's, "Your time" under it gives the same moment in yours.
  4. Tap Add to Google Calendar or Add to Outlook on an event. Your calendar opens in a new tab with the event filled in; check it and save it there. For Google, sign in to Google in the phone's browser first: signed out, Google opens its home page instead of the event.

Each button adds one event. A repeating event keeps its repeat in Google; Outlook's link adds the first date only, and the viewer says so under the event. For a file with dozens of events, tap Download all (.ics) and import that one file on a computer, as in the last section.

The file you open is read in this browser tab and never uploaded. When you press Add to Google Calendar or Add to Outlook, that one event's title, times, place and notes go to Google or Microsoft in the link that opens their calendar. Close the tab and the file is gone; nothing is saved.

An invitation or a plain file? What Gmail shows

Three kinds of email put events near your calendar, and only one of them needs the file.

  • An invitation from Google Calendar. Google's steps for the Gmail app: open the email invitation, and "At the top of the email, select a response": Yes, No or Maybe. The event is already in your Google Calendar or goes there when you answer, depending on Add invitations to my calendar (Google Calendar on a computer › Settings › Event settings): From everyone, Only if the sender is known, or When I respond to the invitation in email.
  • A booking confirmation. Gmail adds flights, trains, buses, hotels, restaurants and ticketed events to Google Calendar by itself, with no file, when "events from Gmail" is on. Google says it is off by default in the European Economic Area, Japan, Switzerland and the UK, and on elsewhere.
  • A plain .ics attachment. A school timetable, a club's season, a file an AI chat made: an attachment like any other, with no Yes or No above it. This is the file the viewer opens.

If the email has both an answer bar and an .ics attachment, answer in Gmail. The file is the same event for people whose calendar doesn't read Gmail's answer.

Android: Gmail and Google Calendar

On Android, Gmail Help gives two ways to keep an attachment: tap Download, or tap Save to Drive. Download is the one to use here: the file lands in the phone's Downloads, where the viewer's Choose an .ics file finds it.

The Google Calendar app can't take the file. Google's import page has a tab for Android phones and tablets, and all it says is: "To import events, open Google Calendar on your computer." So the choices on the phone are the viewer's Add to Google Calendar, one event at a time, or a computer for the whole file. More on why, and on Galaxy phones, in importing an .ics file to Google Calendar on Android or iPhone and importing an .ics file into Samsung Calendar.

iPhone: Gmail, Apple Mail or the viewer

Gmail Help's iPhone steps for attachments are written for photos: tap the attachment to open it, then Download, Drive, Photos or Share. For other files it documents Save to Drive. It doesn't say what the app offers for an .ics file, and we haven't checked on an iPhone. If you can save the file to the Files app, the viewer's Choose an .ics file picks it from there.

Users report the dead end. In a February 2020 thread on Apple's forum (iPad Pro, iOS 13), the poster wrote that the Gmail app showed "a nice screen showing the calendar event, but no option to add it to any calendar. There is a share button on the screen, but no Calendar icon there either." In Apple's Mail app, the same attachment offered to add the event and to choose the calendar. 571 people marked "Me too". That is one user's report from 2020, not Google's or Apple's steps.

Two other routes, each with its own limit:

  • Apple's Mail app with your Gmail account. Apple's iOS 27 guide says, in one line on its calendar-accounts page, that you can "import an .ics file from Mail". It gives no steps; the routes iPhone users report are in importing an .ics calendar file on iPhone.
  • A Mac. For an iCloud calendar, Apple documents importing the file on a Mac (Calendar › File › Import), and the events sync to the iPhone.

On a computer: Gmail on the web, then Import

For a file with many events, a computer brings them all in at once, repeats included. Google's steps:

  1. In Gmail, open the message. At the bottom, hover over the attachment and click Download.
  2. Open Google Calendar. At the top right, click Settings, then Import & Export in the menu on the left.
  3. Click Select file from your computer and choose the .ics file.
  4. Choose which calendar to add the events to (your primary calendar unless you pick another), then click Import.

Google adds that guests and conference data aren't imported. A big file is easier to undo in a calendar of its own: make one first, import into it, and delete it if the events are wrong. The steps, and the 1 MB limit Google gives, are in the Google Calendar guide.

Check the .ics file from the email

An attachment that does nothing when tapped may not be a calendar at all: a web page saved with an .ics name, an empty download, or a calendar with no events. Save it, then check it here, on the phone or a computer.

Check the .ics file from the email

To check it by hand:

  1. On a computer, open the file in a text editor, such as TextEdit or Notepad.
  2. It should start with BEGIN:VCALENDAR. Each event starts with BEGIN:VEVENT; count those lines to count the events.
  3. The SUMMARY: lines hold the titles and the DTSTART: lines the start dates.
  • "This is a web page" or no events: no calendar will take it. Ask the sender for the file again, or for the calendar's link.
  • One event: the viewer's Add to Google Calendar or Add to Outlook is quicker than any import.
  • Dozens of events or repeats with no end: import it on a computer, into a calendar of its own.

Still stuck? An .ics file that won't open goes through each app's cause and fix.

What we tested, and what we didn't

We opened our own sample .ics files in the viewer and in the check on this page, in Chromium (the engine behind Chrome) and WebKit (the engine behind Safari), at phone and desktop widths. We didn't use the Gmail app on an iPhone or Android phone, and we didn't sign in to Google or Microsoft: the Gmail and Google Calendar steps above are Google's own, and the iPhone report is a user's.

Questions

How do I add an ICS file from Gmail to my iPhone calendar?

Save the attachment, then open it in the free ICS viewer in Safari and tap Add to Google Calendar or Add to Outlook on each event: it lands in that account, which the iPhone's Calendar shows once the account is added there. For an iCloud calendar, Apple documents importing a file on a Mac (Calendar › File › Import). Apple's iPhone guide also mentions importing an .ics file from Apple's Mail app, without steps.

Why can't I add an ICS attachment to my calendar from the Gmail app?

The Gmail app shows a Yes, No or Maybe answer for invitations, but Google's help gives no step for adding a plain .ics attachment to a calendar from the app, and the Google Calendar app can't import a file at all: Google's help sends you to a computer. Download the attachment and open it in the ICS viewer, or import it in Google Calendar on a computer.

How do I add an ICS file to Google Calendar from Gmail on a computer?

In Gmail, hover over the attachment and click Download. Then in Google Calendar, click Settings › Import & Export › Select file from your computer, choose the file and the calendar, and click Import. Every event in the file comes in at once.

Sources