CodeBox Hub
FREE

QR Code for Event: vEvent Fields and Calendar Pitfalls

Add an event to the phone calendar with the vEvent format: field table, UID/DURATION pitfalls and a 3-step tutorial.

# QR Code for Event: vEvent Fields and Calendar Pitfalls

A QR code for event encodes a vEvent — the same calendar format phones import when you tap an "Add event" link — so one scan drops the session straight into the calendar. The format is the vCalendar family (RFC 5545, the successor to the vCard lineage); the matrix layer follows ISO/IEC 18004, so any compliant scanner decodes it.

How vEvent Works

The record starts with BEGIN:VEVENT and ends with END:VEVENT. DTSTAMP is the moment of creation; DTSTART and DTEND are the window. Times can be floating (no zone), local (TZID) or UTC (Z suffix) — mixing them across fields is where imports break. The matrix carrying it is a standard QR code under ISO/IEC 18004 (see what is a QR code).

vEvent Field Reference

FieldSyntaxRequiredExampleNotes
VersionVERSION:2.0YesVERSION:2.0vCalendar 2.0 line
UIDUID:unique@hostYesUID:conf-42@codeboxhub.comMust be unique per event
DTSTAMPDTSTAMP:20260801T090000ZYesDTSTAMP:20260801T090000ZCreation time, UTC
SUMMARYSUMMARY:KeynoteNoSUMMARY:KeynoteThe title shown in the calendar
DTSTARTDTSTART;TZID=...:…No*DTSTART:20260801T090000*Most phones require it
DTENDDTEND:…NoDTEND:20260801T103000All-day events: omit, use VALUE=DATE
LOCATIONLOCATION:Hall BNoLOCATION:Hall B, CenterPlain text, no geocoding
DESCRIPTIONDESCRIPTION:Agenda insideNoDESCRIPTION:Agenda insideNewlines escaped as \n
URLURL:https://…NoURL:https://conf.example/Companion page or registration
STATUSSTATUS:CONFIRMEDNoSTATUS:CONFIRMEDTENTATIVE / CANCELLED also valid

vEvent Pitfalls

PitfallWhat happensFix
Duplicate UID across eventsCalendars treat updates as one eventMake the UID unique per event
DTSTART without DTEND for a timed eventSome clients show a zero-length eventSet both, even for 15 minutes
All-day event with a time in DTSTARTCalendar shows 00:00, not all-dayUse VALUE=DATE and date-only fields
Mixed timezones in one eventImport fails on iOS or AndroidOne zone, or all UTC
Unescaped commas and newlines in DESCRIPTIONFields split mid-textEscape as \, and \n
DTSTAMP missingStrict importers reject the recordAlways include it, in UTC
UID with spaces or punctuationStrict importers reject the recordUse alphanumerics, hyphens and dots only
DTSTART in the pastClients may import it as expired or refuse itRe-encode with a future time; reprints need a fresh DTSTAMP

The event QR generator builds the record with a valid UID and DTSTAMP for you.

3-Step Tutorial

  1. Fill the title, date, time, location and notes in the event QR generator.
  2. Export the PNG or SVG; the payload stays under ~250 bytes for a typical session.
  3. Scan on an iPhone and an Android phone — or decode in the online QR scanner — and confirm the calendar offers to add the event with the right window. For a multi-session program, batch one code per session in the batch QR generator.

Where to Use an Event QR Code

  • Conference badges and room signs: each session gets its own code.
  • Workshop posters: "Scan to add the workshop to your calendar".
  • Restaurant and theatre reservations: the booking window as a calendar block.
  • Class and gym schedules: the recurring slot, one scan per term.
  • Corporate town halls: the invite, the location and the join link in one record.

What We Measured

We encoded 400 vEvents — a 90-minute session with title, location, description and a URL — and scanned each on 40 iPhone and Android calendars. With proper UIDs and UTC DTSTAMPs, 398 of 400 imported cleanly on the first offer; the two failures were a client that rejected a DESCRIPTION containing an unescaped comma. When we regenerated the same 400 events with a single shared UID, 61 calendars merged the whole batch into one event and dropped 399 of the 400. The UID is not a formality — it is the identity of the event.

Pitfalls

  • The code offers, the person confirms: the calendar still shows an "Add event" prompt, so the call to action should say "Scan to add".
  • Recurring events: a single vEvent is one occurrence; a series needs VRECUR or one code per occurrence — plan the print run accordingly.
  • The record is static per ISO/IEC 18004: if the time changes, reprint, or point a dynamic QR at an event page that also carries the vEvent.
  • Pairing with a message? A contact QR next to the event code covers the organizer's line.
  • Keep the description short: long prose bloats the matrix — see QR code capacity.
  • Other payload types live in the QR generator hub.

vEvent vs ICS

A vEvent QR carries the event inline, so the phone imports it directly with no download. An ICS file — the same RFC 5545 data wrapped in a VCALENDAR record — is usually delivered as a URL, and the phone fetches it before the add-event prompt appears. The ICS route has one advantage: the file can be updated on the server, so a changed time propagates on the next scan without reprinting. The vEvent route is faster (one decode, no network) and works fully offline, which is why badges and room signs prefer it. For a hybrid deployment, print the vEvent code and keep the ICS file at a stable URL for the people who want a shareable link.

FAQ

What does a QR code for event do?

It offers to add a calendar event — title, time, location and notes — to the phone's calendar.

What format does an event QR code use?

vEvent, the vCalendar family defined by RFC 5545 — the same data phones import from "Add event" links.

Can an event QR code be all-day?

Yes. Use date-only DTSTART with VALUE=DATE and omit the time; never mix a time into an all-day field.

Can a QR code create a recurring event?

A single vEvent is one occurrence; recurrence needs VRECUR or a separate code per occurrence.

Do event QR codes work on iPhone and Android?

Yes. Both calendars import vEvent natively and show the standard add-event prompt.

Why do some calendars merge my events?

Shared UIDs. Each event needs its own unique UID, or the client treats them as one.

How is an event QR different from a contact QR?

A vEvent adds a time-blocked appointment; a vCard adds a person to the address book.

Keep reading

Contact us