Word JavaScript API Hidden Document requirement set 1.5

The WordApiHiddenDocument 1.5 requirement set is a special requirement set that includes features that are only available for Word on Windows and on Mac. APIs in this requirement set are considered to be production APIs for the Word application on Windows and on Mac. They follow Microsoft 365 developer support policies. WordApiHiddenDocument APIs are considered to be "preview" APIs for other platforms (web, iPad) and may not be supported by any of those platforms.

When APIs in the WordApiHiddenDocument requirement set are supported across all platforms, they will be added to a subsequent released requirement set (WordApi 1.[FUTURE]) and no longer tagged as WordApiHiddenDocument. Think of this as a similar promotion process to an API moving from preview to release.


WordApiHiddenDocument 1.5 is a superset of the WordApi 1.5 and WordApiHiddenDocument 1.4 requirement sets, and is a desktop-only requirement set.

Because WordApiHiddenDocument APIs are only supported by Word on Windows and on Mac, your add-in should check if the requirement set is supported before calling these APIs. This avoids any attempt to use desktop-only APIs on an unsupported platform.

if (Office.context.requirements.isSetSupported("WordApiHiddenDocument", "1.5")) {
   // Any API exclusive to this desktop-only requirement set.

Once the API is in a cross-platform requirement set, you should remove or edit the isSetSupported check. This will enable your add-in's feature on other platforms. Be sure to test the feature on those platforms when making this change.


Your manifest cannot specify WordApiHiddenDocument 1.5 as an activation requirement. It's not a valid value to use in the Set element.

API list

The following table lists the Word JavaScript APIs currently included in the WordApiHiddenDocument requirement set. For a complete list of all Word JavaScript APIs (including WordApiHiddenDocument APIs and previously released APIs), see all Word JavaScript APIs.

Class Fields Description
DocumentCreated addStyle(name: string, type: Word.StyleType) Adds a style into the document by name and type.
getContentControls(options?: Word.ContentControlOptions) Gets the currently supported content controls in the document.
getStyles() Gets a StyleCollection object that represents the whole style set of the document.
insertFileFromBase64(base64File: string, insertLocation: Word.InsertLocation.replace | Word.InsertLocation.start | Word.InsertLocation.end | "Replace" | "Start" | "End", insertFileOptions?: Word.InsertFileOptions) Inserts a document into the target document at a specific location with additional properties.
save(saveBehavior?: Word.SaveBehavior, fileName?: string) Saves the document.

See also