Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
subject property

Appointment.subject property (JavaScript API for Office)

Office Add-ins

Gets or sets the description that appears in the subject field of an appointment.

Last modified: August 07, 2015

Note Note

The name "apps for Office" is changing to "Office Add-ins". During the transition, the documentation and the UI of some Office host applications and Visual Studio tools might still use the term "apps for Office". For details, see New name for apps for Office and SharePoint.

Hosts:Outlook

Add-in type: Mail

Available in requirement sets

Mailbox

Last changed in Mailbox

1.1

Applicable Outlook modes

Compose or read

See all support details

var mySubject = Office.context.mailbox.item.subject;

Description

Support notes

In compose mode, a Subject object that provides the getAsync and setAsync methods to get and set the subject of an appointment.

Requires Mailbox requirement set 1.1 or later.

In read mode, a string that specifies the subject of the appointment.

Available in Mailbox requirements set 1.1 or later.

The subject property gets or sets the complete subject of the appointment, as sent by the email server. To get the subject minus any leading prefixes such as "RE:" and "FW:" in a read mode Office Add-in, use the normalizedSubject property.

A checkmark (√) in the following table indicates that this property is supported in the corresponding Outlook host application. An empty cell indicates that the Outlook host application doesn't support this property.

For more information about Office host application and server requirements, see Requirements for running Office Add-ins.

Supported hosts, by platform

Office for Windows desktop

Office Online
(in browser)

OWA for Devices

Office for Mac

Outlook

√ (Read mode only)

Available in requirement sets

Mailbox

Minimum permission level

ReadItem

Add-in types

Mail

Library

Office.js

Namespace

Office

Version

Changes

1.1

Added support for compose mode mail add-ins. In compose mode, returns a Subject object that provides getAsync and setAsync methods to get and set the subject of an appointment.

1.0

Introduced

Show:
© 2015 Microsoft