Try out our new RRULE tool for creating RRULE compatible strings.

Property Name

ATTENDEE

Purpose

This property defines an "Attendee" within a calendar component.

Value Type

CAL-ADDRESS

Property Parameters

IANA, non-standard, language, calendar user type, group or list membership, participation role, participation status, RSVP expectation, delegatee, delegator, sent by, common name, or directory entry reference property parameters can be specified on this property.

Conformance

This property MUST be specified in an iCalendar object that specifies a group-scheduled calendar entity. This property MUST NOT be specified in an iCalendar object when publishing the calendar information (e.g., NOT in an iCalendar object that specifies the publication of a calendar user's busy time, event, to-do, or journal). This property is not specified in an iCalendar object that specifies only a time zone definition or that defines calendar components that are not group-scheduled components, but are components only on a single user's calendar.

Description

This property MUST only be specified within calendar components to specify participants, non-participants, and the chair of a group-scheduled calendar entity. The property is specified within an "EMAIL" category of the "VALARM" calendar component to specify an email address that is to receive the email type of iCalendar alarm.

The property parameter "CN" is for the common or displayable name associated with the calendar address; "ROLE", for the intended role that the attendee will have in the calendar component; "PARTSTAT", for the status of the attendee's participation; "RSVP", for indicating whether the favor of a reply is requested; "CUTYPE", to indicate the type of calendar user; "MEMBER", to indicate the groups that the attendee belongs to; "DELEGATED-TO", to indicate the calendar users that the original request was delegated to; and "DELEGATED-FROM", to indicate whom the request was delegated from; "SENT-BY", to indicate whom is acting on behalf of the "ATTENDEE"; and "DIR", to indicate the URI that points to the directory information corresponding to the attendee. These property parameters can be specified on an "ATTENDEE" property in either a "VEVENT", "VTODO", or "VJOURNAL" calendar component. They MUST NOT be specified in an "ATTENDEE" property in a "VFREEBUSY" or "VALARM" calendar component. If the "LANGUAGE" property parameter is specified, the identified language applies to the "CN" parameter.

A recipient delegated a request MUST inherit the "RSVP" and "ROLE" values from the attendee that delegated the request to them.

Multiple attendees can be specified by including multiple "ATTENDEE" properties within the calendar component.

Format Definition

This property is defined by the following notation:

 attendee   = "ATTENDEE" attparam ":" cal-address CRLF

 attparam   = *(
            ;
            ; The following are OPTIONAL,
            ; but MUST NOT occur more than once.
            ;
            (";" cutypeparam) / (";" memberparam) /
            (";" roleparam) / (";" partstatparam) /
            (";" rsvpparam) / (";" deltoparam) /
            (";" delfromparam) / (";" sentbyparam) /
            (";" cnparam) / (";" dirparam) /
            (";" languageparam) /
            ;
            ; The following is OPTIONAL,
            ; and MAY occur more than once.
            ;
            (";" other-param)
            ;
            )

Example

The following are examples of this property's use for a to-do:

 ATTENDEE;MEMBER="mailto:DEV-GROUP@example.com":
  mailto:joecool@example.com
 ATTENDEE;DELEGATED-FROM="mailto:immud@example.com":
  mailto:ildoit@example.com

The following is an example of this property used for specifying multiple attendees to an event:

 ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=TENTATIVE;CN=Henry
  Cabot:mailto:hcabot@example.com
 ATTENDEE;ROLE=REQ-PARTICIPANT;DELEGATED-FROM="mailto:bob@
  example.com";PARTSTAT=ACCEPTED;CN=Jane Doe:mailto:jdoe@
  example.com

The following is an example of this property with a URI to the directory information associated with the attendee:

 ATTENDEE;CN=John Smith;DIR="ldap://example.com:6666/o=ABC%
  20Industries,c=US???(cn=Jim%20Dolittle)":mailto:jimdo@
  example.com

The following is an example of this property with "delegatee" and "delegator" information for an event:

 ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=TENTATIVE;DELEGATED-FROM=
  "mailto:iamboss@example.com";CN=Henry Cabot:mailto:hcabot@
  example.com
 ATTENDEE;ROLE=NON-PARTICIPANT;PARTSTAT=DELEGATED;DELEGATED-TO=
  "mailto:hcabot@example.com";CN=The Big Cheese:mailto:iamboss
  @example.com
 ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=ACCEPTED;CN=Jane Doe
  :mailto:jdoe@example.com

Example

The following is an example of this property's use when another calendar user is acting on behalf of the "Attendee":

 ATTENDEE;SENT-BY=mailto:jan_doe@example.com;CN=John Smith:
  mailto:jsmith@example.com

This document was automatically converted to XHTML using an RFC to HTML converter with the original text document at the Internet Engineering Task Force web site at ietf.org .  The original text document should be referred to if there are any errors or discrepancies found in this document.

Need to test your iCalendar feeds?

The iCalendar Validator provides developers and testers a method to validate their iCalendar feeds, which can take data from either a URL, file or text snippet and compare it against the RFC 5545 specification.  We believe we have one of the best iCalendar validation tools available on the internet. More information about the validator can be found here.