Add to Calendar links

Save the date, anywhere

Let users add your events to their calendar of choice in one click. 

composer require symfony/ux-calendar-link

  • One-click add

    Visitors save your event without copying anything.

  • Every provider

    Google, Outlook, Yahoo and iCalendar files.

  • Recurring events

    Daily, weekly or custom repeat rules.

  • Timezone correct

    Dates land right wherever the visitor is.

  • One Twig function

    ux_calendar_links() returns every link.

One object, every calendar

Describe the event once.

A CalendarEvent carries the dates and everything optional around them. The Twig function turns it into one link per provider, and the buttons below are the real thing.

A simple event

Create a CalendarEvent with a title, a start and an end date, and optionally a location and a description.

Then call ux_calendar_links(event) in your Twig template to get one link per registered provider.

$event = new CalendarEvent(
    title: 'SymfonyCon Warsaw 2026',
    start: new \DateTimeImmutable(
        '2026-11-26 09:00', $timezone,
    ),
    end: new \DateTimeImmutable(
        '2026-11-27 18:00', $timezone,
    ),
    location: 'Hilton Warsaw Hotel',
);

Try the links it produces

Google Calendar Outlook.com iCalendar (.ics)

A recurring, all-day event

For events that repeat on a fixed schedule, birthdays, public holidays, weekly team meetings, you do not want people adding them by hand every time.

Set allDay: true when the event spans the whole day, and pass a CalendarRecurrence to let the calendar handle the repetition.

Note

Recurrence is honored by Google Calendar and the .ics file only.

$event = new CalendarEvent(
    title: 'Victory in Europe Day',
    start: new \DateTimeImmutable(
        '2025-05-08', $timezone,
    ),
    end: new \DateTimeImmutable(
        '2025-05-09', $timezone,
    ),
    allDay: true,
    recurrence: CalendarRecurrence::yearly(),
);

Try the links it produces

Google Calendar Outlook.com iCalendar (.ics)

An event with a reminder

Having the event in the calendar is a good start, but some appointments really need a heads-up.

Pass one or more CalendarReminder instances to warn people ahead of time: a day before, an hour before, whatever the event deserves.

Note

Reminders are honored by the .ics file only.

$event = new CalendarEvent(
    title: 'Blood donation',
    start: new \DateTimeImmutable(
        '2025-06-12 14:00', $timezone,
    ),
    end: new \DateTimeImmutable(
        '2025-06-12 15:00', $timezone,
    ),
    reminders: [
        CalendarReminder::before(
            days: 1,
            description: 'Eat and drink well.',
        ),
        CalendarReminder::before(
            hours: 2,
            description: 'Time to go!',
        ),
    ],
);

Try the links it produces

Google Calendar Outlook.com iCalendar (.ics)

Install CalendarLink.

$ composer require symfony/ux-calendar-link

More from Symfony UX.

CalendarLink is one package among many. They share the same Stimulus foundation and install the same way.

Image for the Icons UX package

Icons

Render SVG icons seamlessly from your Twig templates.

Image for the Map UX package

Map

Render interactive Maps in PHP with Leaflet or Google Maps.

Image for the Twig Components UX package

Twig Components

Create PHP classes that can render themselves

Browse every package

Keep CalendarLink at hand.

Documentation, the people behind it, and where to ask when something does not behave.

Documentation

Symfony UX CalendarLink Docs
Community

Feedback · support · contributions.
Support

Get help with Symfony UX CalendarLink