[Table of Contents] [docx version]

WordprocessingML Reference Material - Table of Contents

altChunk (Anchor for Imported External Content)

This element specifies a location within a document for the insertion of the contents of a specified file containing external content to be imported into the main WordprocessingML document. The specified file's contents should appear at the specified location within the document, and may henceforth be emitted as regular WordprocessingML without distinction to its origin. The location of the external content to be imported shall be specified by the relationship whose Id attribute matches the id attribute on this element.

If the relationship type of the relationship specified by this element is not http://schemas.openxmlformats.org/officeDocument/2006/afChunk, is not present, or does not have a TargetMode attribute value of Internal, then the document shall be considered non-conformant. If an application cannot process external content of the content type specified by the targeted part, then it should ignore the specified alternate content but continue to process the file. If possible, it should also provide some indication that unknown content was not imported.

[Example: Consider a WordprocessingML document consisting of contents which shall be imported from the following HTML document:

<html … >
<body style="margin-left:200px;margin-top:50px">
<p>Paragraph one.</p>
<blockquote style="border:5px solid #00FFFF">Paragraph in a blockquote.</blockquote>
<p>Paragraph two.</p>

The resulting WordprocessingML host document would consist of its own WordprocessingML content as well as an external content import anchor in the appropriate location:

<w:altChunk r:id="altChunk1" />


The altChunk element specifies that the external content targeted by the relationship with an ID of altChunk1 shall be imported at the beginning of the document. Examining the contents of the corresponding relationship part item, we can see the targets for that relationship:

<Relationships … >

<Relationship Id="altChunk1" TargetMode="Internal" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/afChunk" Target="import.htm" />


The corresponding relationship part item shows that the file to be imported is located next to the main document and is named import.htm. end example]

Parent Elements

body2.2.2); comment2.13.4.2); docPartBody2.12.6); endnote2.11.2); footnote2.11.10); ftr2.10.3); hdr2.10.4); tc2.4.62); txbxContent2.17.1.1)


Child Elements


altChunkPr (External Content Import Properties)





id (Relationship to Part)


Namespace: .../officeDocument/2006/relationships

Specifies the relationship ID to a specified part containing alternate content for import.


If the specified relationship does not match the type required by the parent element, then this document shall be considered to be invalid.


[Example: Consider an XML element which has the following id attribute:


<… r:id="rId10" />


The markup specifies the associated relationship part with relationship ID rId1 contains the corresponding relationship information for the parent XML element. end example]


The possible values for this attribute are defined by the ST_RelationshipId simple type7.8.2.1).

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_AltChunk">


   <element name="altChunkPr" type="CT_AltChunkPr" minOccurs="0" maxOccurs="1"/>


   <attribute ref="r:id" use="optional"/>