The difference between subscribing to a calendar and downloading calendar events
The GravityCalendar Link and GravityCalendar Buttons blocks have a Link Type setting with two choices, Subscribe and Download. Both use the calendar’s subscription address, so Enable calendar subscription link must be turned on in the calendar’s settings.

Subscribe links #
A Subscribe link uses a webcal:// address, the kind of link calendar apps open as a subscription. Once a visitor subscribes, changes to the form’s entries reach their calendar app on their own, which suits a school calendar or a team schedule.
On Android phones, a Subscribe link downloads the calendar file, the same as Download.
How subscriptions stay up to date #
Calendar apps receive a stored copy of the calendar, so they don’t wait for a large calendar to be built on every request. The copy is rebuilt after an entry is added, edited, or deleted, after you save the calendar’s settings, and once it’s an hour old. Subscribers see a change when their calendar app next refreshes the subscription, and each app decides how often that happens. On hosting that uses PHP-FPM, the first refresh after a change still gets the previous copy while the new one is built, so the change shows at the refresh after that.
Approving an entry, or changing a value with GFAPI::update_entry_field(), doesn’t rebuild the copy, so those changes wait until it’s an hour old.
The subscription address changes only when you click Regenerate URL in the calendar’s settings. Regenerating it breaks every existing subscription to the old address, so use it only to cut off access. Developers can adjust or turn off the stored copy with the filters listed in Calendar developer hooks.
If the calendar is deleted or deactivated, or you turn off Enable calendar subscription link, the address answers with a 404 (not found) error, so calendar apps can’t get new events from it.
When a new event doesn’t show in a calendar app
Open the subscription address from the calendar’s settings in a browser. It downloads an .ics file. Open the file in a text editor and look for the event’s title. Because the first requests after a change can return the previous copy, wait a minute and download the file once more before you decide the title is missing.
If the title is there, the calendar is up to date and the app hasn’t checked again yet. If it’s still missing, My calendar or events aren’t displaying covers the causes.
Download links #
A Download link saves an .ics file of the calendar’s events. Visitors import the file into their calendar app, and the imported events do not change after that, even when entries are added to the form. Use it for events that are fixed, such as the dates of a season’s concerts.
Feed events and time zones #
Both link types include events from another calendar feed when Include External Events in Subscription is turned on in the calendar’s settings. Both hold each event’s exact moment in universal time (UTC), so calendar apps show events in the visitor’s own time zone. An all-day event holds only its date. Working with timezones in GravityCalendar explains how that moment is worked out.