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

3.8.1.9. Priority

Property Name

PRIORITY

Purpose

This property defines the relative priority for a calendar component.

Value Type

INTEGER

Property Parameters

IANA and non-standard property parameters can be specified on this property.

Conformance

This property can be specified in "VEVENT" and "VTODO" calendar components.

Description

This priority is specified as an integer in the range 0 to 9. A value of 0 specifies an undefined priority. A value of 1 is the highest priority. A value of 2 is the second highest priority. Subsequent numbers specify a decreasing ordinal priority. A value of 9 is the lowest priority.

A CUA with a three-level priority scheme of "HIGH", "MEDIUM", and "LOW" is mapped into this property such that a property value in the range of 1 to 4 specifies "HIGH" priority. A value of 5 is the normal or "MEDIUM" priority. A value in the range of 6 to 9 is "LOW" priority.

A CUA with a priority schema of "A1", "A2", "A3", "B1", "B2", ..., "C3" is mapped into this property such that a property value of 1 specifies "A1", a property value of 2 specifies "A2", a property value of 3 specifies "A3", and so forth up to a property value of 9 specifies "C3".

Other integer values are reserved for future use.

Within a "VEVENT" calendar component, this property specifies a priority for the event. This property may be useful when more than one event is scheduled for a given time period.

Within a "VTODO" calendar component, this property specified a priority for the to-do. This property is useful in prioritizing multiple action items for a given time period.

Format Definition

This property is defined by the following notation:

 priority   = "PRIORITY" prioparam ":" priovalue CRLF
 ;Default is zero (i.e., undefined).

 prioparam  = *(";" other-param)

 priovalue   = integer       ;Must be in the range [0..9]
    ; All other values are reserved for future use.

Example

The following is an example of a property with the highest priority:

 PRIORITY:1

The following is an example of a property with a next highest priority:

 PRIORITY:2

The following is an example of a property with no priority. This is equivalent to not specifying the "PRIORITY" property:

 PRIORITY:0

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.