Event Schedule Component

Overview

The Event Schedule Component enables event-based QR Codes (like Event and Wedding categories) to include structured scheduling information.
It defines key event details such as start and end dates, time zones, recurrence settings, and calendar integrations.
This ensures that event QR Codes provide accurate, localized, and user-friendly event timing data.

Properties

Property	Type	Required	Description
title	`string`	No	Title of the event. Maximum 50 characters.
startDate	`string`	✅ Yes	Start date of the event (ISO 8601 format recommended).
endDate	`string`	Conditionally required	End date of the event. Required if `allDayEvent` is `false`.
timeZone	`string`	✅ Yes	Time zone identifier (e.g., `Asia/Kolkata`, `UTC`).
repeat	`boolean`	No	Indicates if the event repeats periodically.
recurrence	`string`	No	Defines recurrence frequency. Supported values: `daily`, `weekly`, `monthly`, `yearly`.
allDayEvent	`boolean`	No	Whether the event lasts all day. Default: `false`.
timeFormat	`string`	No	Defines time format for display. Options: `12h` or `24h`. Default: `24h`.
dateFormat	`string`	No	Defines date display format. Options: `MM-dd-yyyy`, `dd-MM-yyyy`, `yyyy-MM-dd`, `M/dd/yyyy`, `MMM d, yyyy`. Default: `MM-dd-yyyy`.
separator	`object`	No	Reference to Separator Component. Controls spacing or visual dividers between sections.
addToCalender	`object`	No	Configuration for “Add to Calendar” actions. Includes `tracking` from Event Tracking Component.
formatting	`object`	No	Defines text and card layout styles via Style Components.

Used in Categories

This component is used in the following QR Code categories:

Example Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "definitions": {},
  "title": "Event Schedule component",
  "description": "Validate event schedule component schema",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "startDate",
    "timeZone"
  ],
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 50,
      "description": "Title of the event"
    },
    "startDate": {
      "type": "string"
    },
    "endDate": {
      "type": "string"
    },
    "timeZone": {
      "type": "string"
    },
    "repeat": {
      "type": "boolean"
    },
    "recurrence": {
      "type": "string",
      "enum": [
        "daily",
        "weekly",
        "monthly",
        "yearly"
      ]
    },
    "allDayEvent": {
      "type": "boolean",
      "default": false
    },
    "timeFormat": {
      "type": "string",
      "default": "24h",
      "enum": [
        "12h",
        "24h"
      ]
    },
    "dateFormat": {
      "type": "string",
      "default": "MM-dd-yyyy",
      "enum": [
        "MM-dd-yyyy",
        "dd-MM-yyyy",
        "yyyy-MM-dd",
        "M/dd/yyyy",
        "MMM d, yyyy"
      ]
    },
    "separator": {
      "$ref": "separator.json"
    },
    "addToCalender": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "tracking": {
          "$ref": "event_tracking.json"
        }
      }
    },
    "formatting": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "textStyle": {
          "$ref": "style/text.json"
        },
        "cardStyle": {
          "$ref": "style/card.json"
        }
      }
    }
  },
  "if": {
    "properties": {
      "allDayEvent": {
        "const": false
      }
    },
    "required": [
      "allDayEvent"
    ]
  },
  "then": {
    "required": [
      "endDate"
    ]
  }
}

Notes

startDate and timeZone are mandatory for defining valid event schedules.
If allDayEvent is false, you must also include endDate.
The addToCalender object allows adding Google Calendar, iCal, or Outlook actions to the landing page.
Ensure proper timezone handling for users accessing the QR Code globally.

Getting Started

Code Examples

Category Components

Categories

Overview

Properties

Used in Categories

Example Schema

Notes

​Overview

​Properties

​Used in Categories

​Example Schema

​Notes

Overview

Properties

Used in Categories

Example Schema

Notes