https://github.com/OfficeDev/office-control-ids
Provides the official IDs of controls in the Office UI
https://github.com/OfficeDev/office-control-ids
Last synced: 3 months ago
JSON representation
Provides the official IDs of controls in the Office UI
- Host: GitHub
- URL: https://github.com/OfficeDev/office-control-ids
- Owner: OfficeDev
- License: mit
- Created: 2020-10-12T17:11:54.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2024-09-07T20:25:33.000Z (about 1 year ago)
- Last Synced: 2025-06-13T00:06:24.246Z (4 months ago)
- Size: 65.4 KB
- Stars: 11
- Watchers: 16
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
- jimsghstars - OfficeDev/office-control-ids - Provides the official IDs of controls in the Office UI (Others)
README
# Office Control IDs
The files in this repo provide the official Office IDs of Office controls and control groups that can be added to custom groups and ribbon tabs by Office Add-ins. Specifically, these IDs are used in the add-in manifest. Where they are used varies depending on the type of manifest that the add-in uses:
- **Unified manifest for Microsoft 365**: The IDs are used as the value of the "builtInControlId" and "builtInGroupId" properties in the ["extensions.ribbons.tabs"](https://learn.microsoft.com/en-us/microsoftteams/platform/resources/schema/manifest-schema#extensionsribbons) section of the manifest.
- **Add-in only manifest**: The IDs are used as the value of the `id` attribute in the [OfficeControl](https://docs.microsoft.com/office/dev/add-ins/reference/manifest/group#control) and [OfficeGroup](https://docs.microsoft.com/office/dev/add-ins/reference/manifest/customtab#officegroup) elements of the manifest.
For an overview of the feature, see [Integrate built-in Office buttons into custom control groups and tabs](https://docs.microsoft.com/office/dev/add-ins/design/built-in-button-integration).
> NOTE: There are limits on which controls, which Office applications, and which platforms support the manifest markup described above. The files in this repo do not include IDs for unsupported scenarios.
>
> In particular, only PowerPoint add-ins are supported at this time.
## Instructions
To find the ID of a control or control group:
1. Open the folder for the Office application; for example, PowerPoint.
1. Open the Excel workbook for the platform; for example, `PowerPoint on the web Ribbon IDs.xlsx`.
1. To find a control ID:
1. Open the **Controls** tab.
1. Filter the **Ribbon Tab ID** column to include only the tab that has the built-in control that you want to insert in a custom group.
1. Look in the **Office ID** column to find the ID. If it is not listed, then the control is not supported by the `` element and you cannot include it in your custom group.
1. To find a group ID:
1. Open the **Single Line Ribbon Groups** tab.
1. Filter the **Ribbon Tab ID** column to include only the tab that has the built-in group that you want to insert in a custom ribbon tab.
1. Look in the **Office ID** column to find the ID *and make a note of it*, if it is there.
1. Open the **Multiline Ribbon Groups** tab.
1. Filter the **Ribbon Tab ID** column to include only the tab that has the built-in group that you want to insert in a custom ribbon tab.
1. Look in the **Office ID** column to find the ID *and make a note of it*, if it is there. (If it is listed on both worksheets, it should be exactly the same ID.)
1. If the group ID is on *both* worksheets, use it in the `` element. It will be inserted in your custom ribbon tab on both the single and multiline ribbons.
1. If the group ID is on *one* worksheet, then you can use it in the `` element, but it will not appear in your custom ribbon tab on the other ribbon type.
1. If the group ID is on *neither* worksheet, then the group is not supported by the `` element and you cannot include it in your custom ribbon tab.
## Trademarks
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
trademarks or logos is subject to and must follow
[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
Any use of third-party trademarks or logos are subject to those third-party's policies.