This documentation is archived and is not being maintained.

How to: Customize the Ribbon UI by using an Office Open XML Formats File

Office 2007

The Ribbon user interface (UI) in the 2007 release of Microsoft® Office suites offers users a flexible way to work with Office applications. Ribbon Extensibility (RibbonX) uses text-based, declarative XML markup that simplifies creating and customizing the Ribbon UI. This sample demonstrates how to add custom components to the Ribbon UI for a single document as opposed to application-level customizations. In the following steps, we add a custom tab, a custom group, and button to the existing Ribbon UI in Microsoft Office Word 2007. We also implement a callback procedure for the button that inserts a company name into the document.

  1. Create the customization file in any text editor and save the file with the name customUI.xml.
  2. Add the following XML markup to the file and then close and save the file:
    <customUI xmlns="">
          <tab id="CustomTab" label="My Tab">
            <group id="SampleGroup" label="Sample Group">
              <button id="Button" label="Insert Company Name" size="large" onAction="ThisDocument.InsertCompanyName" />
            </group >
  3. Create a folder on your desktop named customUI and copy the XML customization file to the folder.
  4. Validate the XML markup with a custom schema.
    Aa434077.vs_note(en-us,office.12).gif  Note
    This step is optional.
  5. Create a document in Word 2007 and save it with the name RibbonSample.docm.
  6. Open the Microsoft Visual Basic® Editor and add the following procedure to the ThisDocument code module and then close and save the document:
    Sub InsertCompanyName(ByVal control As IRibbonControl)
       ' Inserts the specified text at the beginning of a range or selection.
       Dim MyText As String
       Dim MyRange As Object
       Set MyRange = ActiveDocument.Range
       MyText = "Microsoft Corporation"
       ' Range Example: Inserts text at the beginning
       ' of the active document
       MyRange.InsertBefore (MyText)
       ' Selection Example:
       'Selection.InsertBefore (MyText)
    End Sub
  7. Add a .zip extension to the document file name and double-click to open the file.
  8. Add the customization file to the container by dragging the customUI folder from the desktop to the Zip file.
  9. Extract the .rels file to your desktop. A _rels folder containing the .rels file is copied to your desktop.
  10. Open the .rels file and add the following line between the last Relationship tag and the Relationships tag. This creates a relationship between the document file and the customization file:
    <Relationship Id="someID" Type="" Target="customUI/customUI.xml" />
  11. Close and save the file.
  12. Add the _rels folder back to the container file by dragging it from the desktop, overwriting the existing file.
  13. Rename the document file to its original name by removing the .zip extension.
  14. Open the document and notice that the Ribbon UI now displays the My Tab tab.
  15. Click the tab and notice the Sample Group group with a button control.
  16. Click the button and the company name is inserted into the document.

See Also

Overview of the Ribbon User Interface