How to retain alternate data stream associated with a word document while converting it to newer file format version

Recently I encountered a not so common [;-)] scenario while working with Word 2007:

If you have a Word 97-2003 format document which also has an alternate data stream associated with it, converting this document to the newer file format (DOCX file format) in Word 2007 may result in the loss of the associated alternate data stream (ADS).

After researching this, I found that this behavior is by design of Office 2007 convert operation, and it will become more evident from the following, which elaborates what Word 2007 does when a user selects this option.

When you open a Word 97-2003 file format document in Word 2007, you’ll see a new menu-item “Convert” in the Office Pearl menu, as shown below:


On selecting this menu-item, Word will show you a warning saying converting the document to newest format might result in change of the document layout. On selecting OK for that message box, you will assume that the file is now converted to the desired format, but wait that’s not entirely true [:-O].

Instead of immediately converting the document, Word will just mark the current document for conversion to the newest format on the next save/close operation. You can either chose to work with the document or close it immediately. In either of these case, you get a message box saying “Do you want to save the changes”, and clicking “Yes” will actually convert the document before closing it.

Here, conversion of the document to newest format means that Word actually “creates” a new document (DOCX format) and “deletes” the older one. And you might have guessed by now that due to this process, the alternate data stream associated with the original file gets lost.

Now, how do we retain the alternate data stream associated with the older file. Here are some of our options; you can chose either of these based on your scenario:

  1. Repurpose the Convert button implementation using CustomUI XML

  2. Provide a custom button to user for performing this conversion

Option #1

Here, we need to repurpose Office Ribbon command ID “UpgradeDocument”. I will not go into the details of creating a project with custom ribbon XML here; you can refer to following articles to get in-depth documentation for this:

Here is my CustomUI XML for repurposing the Convert button in the Office menu:

<?xml version="1.0" encoding="UTF-8"?>
<customUI xmlns="" onLoad="Ribbon_Load">
<command idMso="UpgradeDocument" onAction="MyConvertHandler"/>

Option #2

For implementing this, we can follow the same path of adding a custom UI XML as in Option #1, and instead of adding a <commands> node, we need to add a custom button for user to click on for converting the document.

For more information on how to add custom buttons to ribbon, you can refer to following articles:

You may also say why not just intercept the Convert document event and add a custom logic to retain the ADS (pretty obvious, huh!). Unfortunately there is no such event available in Word for this operation. We can, however, intercept other events like DocumentBeforeSave/DocumentBeforeClose and form a logic for retaining the alternate data stream of original file.


OK, now that we have a way to intercept the Convert operation, all we need is the logic to retain the ADS for our file. This we will implement as below:

  1. Read the alternate data stream associated with the original file

  2. Convert the document programmatically

    1. Call Document.Convert() 

    2. Call Document.Save() to force Word perform the conversion.

  3. Create a new alternate data stream and associate it with the new file.

  4. Fill the content of the old stream to the new one.

Please see the attached sample project to see an example of this implementation using Option #1.

Things to try

Excel 2007 and PowerPoint 2007 also exhibit the same behavior as Word 2007, i.e., the associated ADS also get lost when an opened workbook/presentation is converted to a latest version. The good part is, you can implement a similar approach for them too, to retain the ADS.

Comments (0)

Skip to main content