extensionRibbonsArrayTabsItem.position object

2025-05-29

Configures the position of a custom tab relative to other tabs on the ribbon.

Properties that reference this object type:

root.extensions.ribbons.tabs.position

Syntax

Syntax
Schema

{
  "builtInTabId": "{string}",
  "align": "after | before"
}

{
  "type": "object",
  "properties": {
    "builtInTabId": {
      "type": "string",
      "description": "The id of the built-in tab. Maximum length is 64 characters.",
      "maxLength": 64
    },
    "align": {
      "type": "string",
      "description": "Define alignment of this custom tab relative to the specified built-in tab.",
      "enum": [
        "after",
        "before"
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "builtInTabId",
    "align"
  ]
}

Properties

builtInTabId

Specifies the ID of the built-in tab that the custom tab should be positioned next to. For more information, see Find the IDs of controls and control groups.

Type
string

Required
✅

Constraints
Maximum string length: 64.

Supported values

align

Defines the alignment of custom tab relative to the specified built-in tab.

Type
string

Required
✅

Constraints

Supported values
Allowed values: after, before.

Remarks

Tab positioning is supported only in PowerPoint add-ins.

Share via