extensionAlternateVersionsArray.alternateIcons object

Specifies the main icons that are used to represent the add-in on older versions of Office. This property is required if the Office add-in is to be installable in Office on Mac, perpetual Office licenses, and Microsoft 365 subscription versions of Office on Windows earlier than 2304 (Build 16320.00000).

Properties that reference this object type:

• root.extensions.alternates.alternateIcons

Syntax

Syntax

{
  "icon": {
    "size": {number},
    "url": "{string}"
  },
  "highResolutionIcon": {
    "size": {number},
    "url": "{string}"
  }
}

Schema

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "icon": {
      "$ref": "#/definitions/extensionCommonIcon"
    },
    "highResolutionIcon": {
      "$ref": "#/definitions/extensionCommonIcon"
    }
  },
  "required": [
    "icon",
    "highResolutionIcon"
  ]
}

Properties

icon

Specifies properties of the image file used to represent the add-in. Icon image must be 64 x 64 pixels and use one of the following file formats: GIF, JPG, PNG, EXIF, BMP, TIFF.

Type
extensionCommonIcon

Required
✅

Constraints

Supported values

highResolutionIcon

Specifies properties of the image file used to represent the add-in on high DPI screens. Icon image must be 128 x 128 pixels and use one of the following file formats: GIF, JPG, PNG, EXIF, BMP, TIFF.

Type
extensionCommonIcon

Required
✅

Constraints

Supported values

Examples

{
    "alternateIcons": {
      "icon": {
        "size": 64,
        "url": "https://contoso.com/assets/icon64x64.jpg"
      },
      "highResolutionIcon": {
        "size": 64,
        "url": "https://contoso.com/assets/icon128x128.jpg"
      }
    }
}