17.17.2.1 altChunk

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 can 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://purl.oclc.org/ooxml/officeDocument/relationships/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 must 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>
  </body>
</html>

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:body>
  <w:altChunk r:id="altChunk1" />
  <w:p/>
  <w:sectPr>
    …
  </w:sectPr>
</w:body>

The altChunk element specifies that the external content targeted by the relationship with an ID of altChunk1 must 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://purl.oclc.org/ooxml/officeDocument/relationships/aFChunk" Target="import.htm"
/>
  …
</Relationships>

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]

Attributes

Namespace: http://purl.oclc.or g/ooxml/officeDoc ument/relationshi ps

[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]

If this attribute is omitted, the parent element shall be ignored.

The possible values for this attribute are defined by the ST_RelationshipId simple type (22.8.2.1).

id (Relationship to Part)

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

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

[Note: The W3C XML Schema definition of this element’s content model (CT_AltChunk) is located in A.1. end note]

Last updated on March 14, 2025

17.17.2.2 altChunkPr