Gets the identifier of the object.

Hosts: Access, Excel, Word
Last changed in 1.1
var bindingID =;

Return Value

A string which uniquely identifies this binding among the bindings in the same Document object.


Office.context.document.bindings.getByIdAsync("myBinding", function (asyncResult) {

// Function that writes to a div with id='message' on the page.
function write(message){
    document.getElementById('message').innerText += message; 

Support details

A capital Y in the following matrix indicates that this method is supported in the corresponding Office host application. An empty cell indicates that the Office host application doesn't support this method.

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) Office for iPad
Access Y
Excel Y Y Y
Word Y Y Y
Minimum permission level Restricted
Add-in types Content, task pane
Library Office.js
Namespace Office

Support history

Version Changes
1.1 Added support for Excel and Word in Office for iPad.
1.1 Added support for binding in add-ins for Access.
1.0 Introduced