Skip to content

Instantly share code, notes, and snippets.

@parj
Created April 21, 2026 11:37
Show Gist options
  • Select an option

  • Save parj/a252a675d1535b28c7811bc86334bcc0 to your computer and use it in GitHub Desktop.

Select an option

Save parj/a252a675d1535b28c7811bc86334bcc0 to your computer and use it in GitHub Desktop.
docx specification
[MS-DOCX]:
Word Extensions to the Office Open XML (.docx) File
Format

Intellectual Property Rights Notice for Open Specifications Documentation Technical Documentation. Microsoft publishes Open Specifications documentation (“this documentation”) for protocols, file formats, data portability, computer languages, and standards support. Additionally, overview documents cover inter-protocol relationships and interactions. Copyrights. This documentation is covered by Microsoft copyrights. Regardless of any other terms that are contained in the terms of use for the Microsoft website that hosts this documentation, you can make copies of it in order to develop implementations of the technologies that are described in this documentation and can distribute portions of it in your implementations that use these technologies or in your documentation as necessary to properly document the implementation. You can also distribute in your implementation, with or without modification, any schemas, IDLs, or code samples that are included in the documentation. This permission also applies to any documents that are referenced in the Open Specifications documentation. No Trade Secrets. Microsoft does not claim any trade secret rights in this documentation. Patents. Microsoft has patents that might cover your implementations of the technologies described in the Open Specifications documentation. Neither this notice nor Microsoft's delivery of this documentation grants any licenses under those patents or any other Microsoft patents. However, a given Open Specifications document might be covered by the Microsoft Open Specifications Promise or the Microsoft Community Promise. If you would prefer a written license, or if the technologies described in this documentation are not covered by the Open Specifications Promise or Community Promise, as applicable, patent licenses are available by contacting [email protected]. License Programs. To see all of the protocols in scope under a specific license program and the associated patents, visit the Patent Map. Trademarks. The names of companies and products contained in this documentation might be covered by trademarks or similar intellectual property rights. This notice does not grant any licenses under those rights. For a list of Microsoft trademarks, visit www.microsoft.com/trademarks. Fictitious Names. The example companies, organizations, products, domain names, email addresses, logos, people, places, and events that are depicted in this documentation are fictitious. No association with any real company, organization, product, domain name, email address, logo, person, place, or event is intended or should be inferred. Reservation of Rights. All other rights are reserved, and this notice does not grant any rights other than as specifically described above, whether by implication, estoppel, or otherwise.

Tools. The Open Specifications documentation does not require the use of Microsoft programming tools or programming environments in order for you to develop an implementation. If you have access to Microsoft programming tools and environments, you are free to take advantage of them. Certain Open Specifications documents are intended for use in conjunction with publicly available standards specifications and network programming art and, as such, assume that the reader either is familiar with the aforementioned material or has immediate access to it.

Support. For questions and support, please contact [email protected].

    1 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

Revision Summary

         Revision   Revision

Date History Class Comments

7/13/2009 0.1 Major Initial Availability

8/28/2009 0.2 Major Updated and revised the technical content

11/6/2009 0.3 Editorial Revised and edited the technical content

2/19/2010 1.0 Major Updated and revised the technical content

3/31/2010 1.01 Editorial Revised and edited the technical content

4/30/2010 1.02 Editorial Revised and edited the technical content

6/7/2010 1.03 Editorial Revised and edited the technical content

6/29/2010 1.04 Editorial Changed language and formatting in the technical content.

7/23/2010 1.04 None No changes to the meaning, language, or formatting of the technical content.

9/27/2010 1.04 None No changes to the meaning, language, or formatting of the technical content.

11/15/2010 1.04 None No changes to the meaning, language, or formatting of the technical content.

12/17/2010 1.05 Minor Clarified the meaning of the technical content.

3/18/2011 1.05 None No changes to the meaning, language, or formatting of the technical content.

6/10/2011 1.05 None No changes to the meaning, language, or formatting of the technical content.

1/20/2012 2.0 Major Significantly changed the technical content.

4/11/2012 2.0 None No changes to the meaning, language, or formatting of the technical content.

7/16/2012 3.0 Major Significantly changed the technical content.

10/8/2012 3.0 None No changes to the meaning, language, or formatting of the technical content.

2/11/2013 3.0 None No changes to the meaning, language, or formatting of the technical content.

7/30/2013 3.0 None No changes to the meaning, language, or formatting of the technical content.

11/18/2013 3.1 Minor Clarified the meaning of the technical content.

2/10/2014 3.2 Minor Clarified the meaning of the technical content.

4/30/2014 4.0 Major Significantly changed the technical content.

7/31/2014 4.1 Minor Clarified the meaning of the technical content.

10/30/2014 4.1 None No changes to the meaning, language, or formatting of the technical content.

                                    2 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

         Revision   Revision

Date History Class Comments

3/16/2015 5.0 Major Significantly changed the technical content.

9/4/2015 6.0 Major Significantly changed the technical content.

7/15/2016 6.1 Minor Clarified the meaning of the technical content.

9/22/2016 7.0 Major Significantly changed the technical content.

12/15/2016 8.0 Major Significantly changed the technical content.

9/5/2017 9.0 Major Significantly changed the technical content.

12/12/2017 9.1 Minor Clarified the meaning of the technical content.

4/27/2018 10.0 Major Significantly changed the technical content.

8/28/2018 11.0 Major Significantly changed the technical content.

12/11/2018 11.1 Minor Clarified the meaning of the technical content.

3/19/2019 11.1 None No changes to the meaning, language, or formatting of the technical content.

9/24/2019 12.0 Major Significantly changed the technical content.

11/19/2019 12.1 Minor Clarified the meaning of the technical content.

2/19/2020 13.0 Major Significantly changed the technical content.

8/18/2020 14.0 Major Significantly changed the technical content.

2/16/2021 14.1 Minor Clarified the meaning of the technical content.

3/22/2021 15.0 Major Significantly changed the technical content.

4/22/2021 16.0 Major Significantly changed the technical content.

8/17/2021 17.0 Major Significantly changed the technical content.

3/4/2022 18.0 Major Significantly changed the technical content.

8/16/2022 18.1 Minor Clarified the meaning of the technical content.

3/3/2023 18.1 None No changes to the meaning, language, or formatting of the technical content.

6/16/2023 19.0 Major Significantly changed the technical content.

8/15/2023 19.1 Minor Clarified the meaning of the technical content.

2/20/2024 19.1 None No changes to the meaning, language, or formatting of the technical content.

4/16/2024 20.0 Major Significantly changed the technical content.

8/20/2024 21.0 Major Significantly changed the technical content.

11/12/2024 21.1 Minor Clarified the meaning of the technical content.

2/18/2025 21.2 Minor Clarified the meaning of the technical content.

5/20/2025 22.0 Major Significantly changed the technical content.

                                3 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

         Revision   Revision

Date History Class Comments

11/13/2025 22.1 Minor Clarified the meaning of the technical content.

                                4 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Table of Contents 1 Introduction .......................................................................................................... 10 1.1 Glossary ......................................................................................................... 10 1.2 References ...................................................................................................... 10 1.2.1 Normative References ................................................................................. 11 1.2.2 Informative References ............................................................................... 11 1.3 Structure Overview (Synopsis) .......................................................................... 12 1.4 Relationship to Protocols and Other Structures .................................................... 12 1.5 Applicability Statement ..................................................................................... 13 1.6 Versioning and Localization ............................................................................... 13 1.7 Vendor-Extensible Fields ................................................................................... 13 2 Structures ............................................................................................................. 14 2.1 Part Enumerations............................................................................................ 14 2.1.1 stylesWithEffects ........................................................................................ 14 2.1.2 commentsExtended .................................................................................... 14 2.1.3 people....................................................................................................... 14 2.1.4 commentsIds ............................................................................................. 14 2.1.5 commentsExtensible ................................................................................... 14 2.2 Extensions ...................................................................................................... 14 2.2.1 rPr Extensions ............................................................................................ 14 2.2.2 Settings Extensions..................................................................................... 14 2.2.3 sdtPr Extensions ......................................................................................... 15 2.2.4 p and tr Extensions ..................................................................................... 15 2.2.5 Conflict Extensions...................................................................................... 15 2.2.6 Pict and Object Extensions ........................................................................... 15 2.2.7 Calendar Type Extensions ............................................................................ 15 2.2.8 sectPr Extensions ....................................................................................... 16 2.2.9 pPr Extensions ........................................................................................... 16 2.2.10 Numbering Definition Extensions .................................................................. 16 2.2.11 r Extensions ............................................................................................... 16 2.2.12 dataBinding Extensions ............................................................................... 16 2.2.13 commentsExtensible Extensions ................................................................... 16 2.3 compatSetting elements ................................................................................... 16 2.3.1 overrideTableStyleFontSizeAndJustification .................................................... 17 2.3.2 doNotFlipMirrorIndents ................................................................................ 17 2.3.3 enableOpenTypeFeatures............................................................................. 17 2.3.4 differentiateMultirowTableHeaders ................................................................ 18 2.3.5 compatibilityMode....................................................................................... 18 2.3.6 allowTextAfterFloatingTableBreak ................................................................. 19 2.3.7 allowHyphenationAtTrackBottom .................................................................. 20 2.3.8 useWord2013TrackBottomHyphenation ......................................................... 20 2.3.9 usePre2018iOSMacLayout ............................................................................ 21 2.4 numFmt Extensions .......................................................................................... 21 2.5 http://schemas.microsoft.com/office/word/2012/wordml ...................................... 28 2.5.1 Elements ................................................................................................... 28 2.5.1.1 appearance .......................................................................................... 28 2.5.1.2 chartTrackingRefBased .......................................................................... 28 2.5.1.3 collapsed ............................................................................................. 29 2.5.1.4 color.................................................................................................... 29 2.5.1.5 commentsEx ........................................................................................ 29 2.5.1.6 dataBinding.......................................................................................... 30 2.5.1.7 docId................................................................................................... 30 2.5.1.8 footnoteColumns................................................................................... 30 2.5.1.9 people ................................................................................................. 31 2.5.1.10 repeatingSection ................................................................................... 31

       5 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

  2.5.1.11 repeatingSectionItem ............................................................................ 31
  2.5.1.12 webExtensionCreated ............................................................................ 32
  2.5.1.13 webExtensionLinked .............................................................................. 32
2.5.2 Attributes .................................................................................................. 33
  2.5.2.1 restartNumberingAfterBreak................................................................... 33
2.5.3 Complex Types........................................................................................... 33
  2.5.3.1 CT_CommentEx .................................................................................... 33
  2.5.3.2 CT_CommentsEx .................................................................................. 34
  2.5.3.3 CT_Guid .............................................................................................. 34
  2.5.3.4 CT_People............................................................................................ 34
  2.5.3.5 CT_Person ........................................................................................... 35
  2.5.3.6 CT_PresenceInfo ................................................................................... 35
  2.5.3.7 CT_SdtAppearance................................................................................ 36
  2.5.3.8 CT_SdtRepeatedSection......................................................................... 37
2.5.4 Simple Types ............................................................................................. 37
  2.5.4.1 ST_Guid............................................................................................... 37
  2.5.4.2 ST_SdtAppearance ................................................................................ 38

2.6 http://schemas.microsoft.com/office/word/2010/wordml ...................................... 38 2.6.1 Elements ................................................................................................... 38 2.6.1.1 checkbox ............................................................................................. 38 2.6.1.2 cntxtAlts .............................................................................................. 39 2.6.1.3 conflictDel ............................................................................................ 39 2.6.1.4 conflictDel ............................................................................................ 39 2.6.1.5 conflictIns ............................................................................................ 39 2.6.1.6 conflictIns ............................................................................................ 40 2.6.1.7 conflictMode ......................................................................................... 40 2.6.1.8 customXmlConflictDelRangeEnd .............................................................. 40 2.6.1.9 customXmlConflictDelRangeStart ............................................................ 41 2.6.1.10 customXmlConflictInsRangeEnd .............................................................. 41 2.6.1.11 customXmlConflictInsRangeStart ............................................................ 41 2.6.1.12 defaultImageDpi ................................................................................... 41 2.6.1.13 discardImageEditingData ....................................................................... 42 2.6.1.14 docId................................................................................................... 42 2.6.1.15 entityPicker .......................................................................................... 42 2.6.1.16 glow .................................................................................................... 44 2.6.1.17 ligatures .............................................................................................. 44 2.6.1.18 numForm ............................................................................................. 44 2.6.1.19 numSpacing ......................................................................................... 45 2.6.1.20 props3d ............................................................................................... 45 2.6.1.21 reflection ............................................................................................. 45 2.6.1.22 scene3d ............................................................................................... 45 2.6.1.23 shadow................................................................................................ 46 2.6.1.24 stylisticSets.......................................................................................... 46 2.6.1.25 textFill ................................................................................................. 46 2.6.1.26 textOutline ........................................................................................... 47 2.6.2 Attributes .................................................................................................. 47 2.6.2.1 anchorId .............................................................................................. 47 2.6.2.2 noSpellErr ............................................................................................ 47 2.6.2.3 paraId ................................................................................................. 47 2.6.2.4 textId .................................................................................................. 48 2.6.3 Complex Types........................................................................................... 48 2.6.3.1 CT_Bevel ............................................................................................. 48 2.6.3.2 CT_Camera .......................................................................................... 49 2.6.3.3 CT_Color.............................................................................................. 49 2.6.3.4 CT_DefaultImageDpi ............................................................................. 50 2.6.3.5 CT_FillTextEffect ................................................................................... 50 2.6.3.6 CT_Glow .............................................................................................. 51 2.6.3.7 CT_GradientFillProperties ....................................................................... 51

    6 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

  2.6.3.8       CT_GradientStop .................................................................................. 52
  2.6.3.9        CT_GradientStopList.............................................................................. 52
  2.6.3.10   CT_Ligatures ........................................................................................ 53
  2.6.3.11   CT_LightRig.......................................................................................... 53
  2.6.3.12          CT_LinearShadeProperties...................................................................... 54
  2.6.3.13         CT_LineJoinMiterProperties..................................................................... 54
  2.6.3.14          CT_LongHexNumber.............................................................................. 55
  2.6.3.15      CT_NumForm ....................................................................................... 55
  2.6.3.16       CT_NumSpacing ................................................................................... 55
  2.6.3.17  CT_OnOff ............................................................................................. 56
  2.6.3.18         CT_PathShadeProperties ........................................................................ 56
  2.6.3.19     CT_Percentage ..................................................................................... 57
  2.6.3.20          CT_PositiveFixedPercentage ................................................................... 57
  2.6.3.21        CT_PositivePercentage........................................................................... 58
  2.6.3.22           CT_PresetLineDashProperties ................................................................. 58
  2.6.3.23    CT_Props3D ......................................................................................... 58
  2.6.3.24   CT_Reflection ....................................................................................... 59
  2.6.3.25     CT_RelativeRect.................................................................................... 60
  2.6.3.26     CT_Scene3D......................................................................................... 61
  2.6.3.27       CT_SchemeColor................................................................................... 62
  2.6.3.28       CT_SdtCheckbox................................................................................... 63
  2.6.3.29           CT_SdtCheckboxSymbol ........................................................................ 63
  2.6.3.30    CT_Shadow .......................................................................................... 64
  2.6.3.31       CT_SolidColorFillProperties ..................................................................... 65
  2.6.3.32       CT_SphereCoords ................................................................................. 65
  2.6.3.33     CT_SRgbColor ...................................................................................... 66
  2.6.3.34   CT_StyleSet ......................................................................................... 67
  2.6.3.35   CT_StylisticSets .................................................................................... 67
  2.6.3.36      CT_TextOutlineEffect ............................................................................. 68

2.6.4 Simple Types ............................................................................................. 69 2.6.4.1 ST_BevelPresetType .............................................................................. 69 2.6.4.2 ST_CompoundLine ................................................................................ 70 2.6.4.3 ST_Ligatures ........................................................................................ 70 2.6.4.4 ST_LightRigDirection ............................................................................. 72 2.6.4.5 ST_LightRigType ................................................................................... 73 2.6.4.6 ST_LineCap .......................................................................................... 74 2.6.4.7 ST_NumForm ....................................................................................... 75 2.6.4.8 ST_NumSpacing ................................................................................... 76 2.6.4.9 ST_OnOff ............................................................................................. 76 2.6.4.10 ST_PathShadeType ............................................................................... 77 2.6.4.11 ST_PenAlignment.................................................................................. 77 2.6.4.12 ST_PresetCameraType........................................................................... 78 2.6.4.13 ST_PresetLineDashVal ........................................................................... 81 2.6.4.14 ST_PresetMaterialType .......................................................................... 82 2.6.4.15 ST_RectAlignment................................................................................. 83 2.6.4.16 ST_SchemeColorVal .............................................................................. 84 2.7 http://schemas.microsoft.com/office/word/2015/wordml/symex ............................ 86 2.7.1 Elements ................................................................................................... 86 2.7.1.1 symEx ................................................................................................. 86 2.7.2 Attributes .................................................................................................. 86 2.7.3 Complex Types........................................................................................... 86 2.7.3.1 CT_SymEx ........................................................................................... 86 2.7.4 Simple Types ............................................................................................. 87 2.8 http://schemas.microsoft.com/office/word/2016/wordml/cid ................................. 87 2.8.1 Elements ................................................................................................... 87 2.8.1.1 commentsIds ....................................................................................... 87 2.8.2 Attributes .................................................................................................. 87 2.8.2.1 durableId ............................................................................................. 87

      7 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

   2.8.2.2    durableId ............................................................................................. 87

2.8.3 Complex Types........................................................................................... 88 2.8.3.1 CT_CommentId .................................................................................... 88 2.8.3.2 CT_CommentsIds.................................................................................. 88 2.8.4 Simple Types ............................................................................................. 89 2.9 http://schemas.microsoft.com/office/word/2018/wordml ...................................... 89 2.9.1 Elements ................................................................................................... 89 2.9.2 Attributes .................................................................................................. 89 2.9.3 Complex Types........................................................................................... 89 2.9.3.1 CT_Extension ....................................................................................... 89 2.9.3.2 CT_ExtensionList .................................................................................. 89 2.9.4 Simple Types ............................................................................................. 90 2.10 http://schemas.microsoft.com/office/word/2018/wordml/cex ................................ 90 2.10.1 Elements ................................................................................................... 90 2.10.1.1 commentsExtensible.............................................................................. 90 2.10.2 Attributes .................................................................................................. 90 2.10.3 Complex Types........................................................................................... 90 2.10.3.1 CT_CommentExtensible ......................................................................... 90 2.10.3.2 CT_CommentsExtensible........................................................................ 91 2.10.4 Simple Types ............................................................................................. 91 2.11 http://schemas.microsoft.com/office/word/2020/wordml/sdtdatahash .................... 92 2.11.1 Elements ................................................................................................... 92 2.11.2 Attributes .................................................................................................. 92 2.11.2.1 storeItemChecksum .............................................................................. 92 2.11.3 Complex Types........................................................................................... 92 2.11.4 Simple Types ............................................................................................. 92 2.12 http://schemas.microsoft.com/office/word/2023/wordml/word16du ....................... 92 2.12.1 Elements ................................................................................................... 92 2.12.2 Attributes .................................................................................................. 92 2.12.2.1 dateUtc................................................................................................ 92 2.12.3 Complex Types........................................................................................... 93 2.12.4 Simple Types ............................................................................................. 93 2.13 http://schemas.microsoft.com/office/word/2024/wordml/sdtformatlock.................. 93 2.13.1 Elements ................................................................................................... 93 2.13.2 Attributes .................................................................................................. 93 2.13.2.1 formattingAllowed ................................................................................. 93 2.13.3 Complex Types........................................................................................... 93 2.13.4 Simple Types ............................................................................................. 93 3 Structure Examples ............................................................................................... 94 3.1 Glowing Text ................................................................................................... 94 3.2 Stylistic Sets ................................................................................................... 94 4 Security Considerations ......................................................................................... 96 4.1 Security Considerations for Implementers ........................................................... 96 4.2 Index of Security Fields .................................................................................... 96 5 Appendix A: Full XML Schemas .............................................................................. 97 5.1 http://schemas.microsoft.com/office/word/2010/wordml Schema .......................... 97 5.2 http://schemas.microsoft.com/office/word/2012/wordml Schema .........................105 5.3 http://schemas.microsoft.com/office/word/2015/wordml/symex Schema...............107 5.4 http://schemas.microsoft.com/office/word/2016/wordml/cid Schema ....................107 5.5 http://schemas.microsoft.com/office/word/2018/wordml Schema .........................107 5.6 http://schemas.microsoft.com/office/word/2018/wordml/cex Schema ...................108 5.7 http://schemas.microsoft.com/office/word/2020/wordml/sdtdatahash Schema .......108 5.8 http://schemas.microsoft.com/office/word/2023/wordml/word16du Schema ..........108 5.9 http://schemas.microsoft.com/office/word/2024/wordml/sdtformatlock Schema.....108 6 Appendix B: Product Behavior ............................................................................. 110

       8 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

7 Change Tracking.................................................................................................. 113 8 Index................................................................................................................... 114

   9 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

1 Introduction

This document specifies elements and attributes that extend the XML vocabulary for representing word processing documents specified in the ISO/IEC-29500 specification. The new elements and attributes are presented using the extensibility mechanisms provided by the ISO/IEC-29500 specification.

Sections 1.7 and 2 of this specification are normative. All other sections and examples in this specification are informative.

1.1 Glossary

This document uses the following terms:

base64 encoding: A binary-to-text encoding scheme whereby an arbitrary sequence of bytes is converted to a sequence of printable ASCII characters, as described in [RFC4648].

cyclic redundancy check (CRC): An algorithm used to produce a checksum (a small, fixed number of bits) against a block of data, such as a packet of network traffic or a block of a computer file. The CRC is a broad class of functions used to detect errors after transmission or storage. A CRC is designed to catch random errors, as opposed to intentional errors. If errors might be introduced by a motivated and intelligent adversary, a cryptographic hash function has to be used instead.

entity: An instance of an EntityType element that has a unique identity and an independent existence. An entity is an operational unit of consistency.

EntityInstance: A set of Field values that have a unique identity that represents a specific instance of an Entity, and are stored in a line-of-business (LOB) system.

EntityInstanceId: A set of Field values of an EntityInstance that collectively and uniquely identify an EntityInstance in a line-of-business (LOB) system.

external content type: A type of DataClass object that is stored in a line-of-business (LOB) system and whose instances have a persistent EntityInstanceId. Also referred to as Entity.

field: An element or attribute in a data source that can contain data.

follow-up: A note that a user leaves for further review later. Follow-ups can be used by an app to display in a special visual format, to provide navigation, or to provide special behaviors such as reminders.

LobSystemInstance: A type of MetadataObject that represents a specific deployed instance of a line-of-business (LOB) system, as represented by a LobSystem. LobSystemInstances are contained by LobSystems. LobSystemInstance Properties describe how to connect to an instance of the LobSystem that contains them by providing information such as the server name, connection string, and authentication mode.

Unicode: A character encoding standard developed by the Unicode Consortium that represents almost all of the written languages of the world. The Unicode standard [UNICODE5.0.0/2007] provides three forms (UTF-8, UTF-16, and UTF-32) and seven schemes (UTF-8, UTF-16, UTF-16 BE, UTF-16 LE, UTF-32, UTF-32 LE, and UTF-32 BE).

MAY, SHOULD, MUST, SHOULD NOT, MUST NOT: These terms (in all caps) are used as defined in [RFC2119]. All statements of optional behavior use either MAY, SHOULD, or SHOULD NOT.

    10 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

1.2 References

Links to a document in the Microsoft Open Specifications library point to the correct section in the most recently published version of the referenced document. However, because individual documents in the library are not updated at the same time, the section numbers in the documents may not match. You can confirm the correct section numbering by checking the Errata.

1.2.1 Normative References

We conduct frequent surveys of the normative references to assure their continued availability. If you have any issue with finding a normative reference, please contact [email protected]. We will assist you in finding the relevant information.

[ECMA-376] ECMA International, "Office Open XML File Formats", https://www.ecma- international.org/publications-and-standards/standards/ecma-376/

[ISO/IEC-14496-22] International Organization for Standardization, "Information technology -- Coding of audio-visual objects -- Part 22: Open Font Format", 2007, http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=43466

[ISO/IEC29500-1:2016] ISO/IEC, "Information technology -- Document description and processing languages -- Office Open XML File Formats -- Part 1: Fundamentals and Markup Language Reference", ISO/IEC 29500-1:2016, https://www.iso.org/standard/71691.html

[ISO/IEC29500-3:2015] ISO/IEC, "Information technology -- Document description and processing languages -- Office Open XML File Formats -- Part 3: Markup Compatibility and Extensibility", https://www.iso.org/standard/65533.html

[ISO/IEC29500-4:2016] ISO/IEC, "Information technology -- Document description and processing languages -- Office Open XML File Formats -- Part 4: Transitional Migration Features", https://www.iso.org/standard/71692.html

[MS-DOC] Microsoft Corporation, "Word (.doc) Binary File Format".

[MS-DTYP] Microsoft Corporation, "Windows Data Types".

[MS-ODRAWXML] Microsoft Corporation, "Office Drawing Extensions to Office Open XML Structure".

[MS-OREACTXML] Microsoft Corporation, "Office Reaction Extensions to Office Open XML Structure".

[MS-OSHARED] Microsoft Corporation, "Office Common Data Types and Objects Structures".

[MS-OWEXML] Microsoft Corporation, "Office Web Extensibility Extensions to Office Open XML Structure Specification".

[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997, https://www.rfc-editor.org/info/rfc2119

[RFC3986] Berners-Lee, T., Fielding, R., and Masinter, L., "Uniform Resource Identifier (URI): Generic Syntax", STD 66, RFC 3986, January 2005, https://www.rfc-editor.org/info/rfc3986

[XMLSCHEMA1/2] Thompson, H., Beech, D., Maloney, M., and Mendelsohn, N., Eds., "XML Schema Part 1: Structures Second Edition", W3C Recommendation, October 2004, https://www.w3.org/TR/2004/REC-xmlschema-1-20041028/

[XMLSCHEMA2/2] Biron, P., and Malhotra, A., Eds., "XML Schema Part 2: Datatypes Second Edition", W3C Recommendation, October 2004, https://www.w3.org/TR/2004/REC-xmlschema-2-20041028/

    11 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

1.2.2 Informative References

None.

1.3 Structure Overview (Synopsis)

The structures specified in this format provide an extended XML vocabulary for a word processing document. The extended elements and attributes allow the format to indicate further information about a document, or to indicate content and formatting of parts of the document beyond the elements and attributes specified in the Office Open XML File Formats specification. Because these elements and attributes are meant as extensions, their intent and usage varies.

The new elements and attributes specified in this format come in six groups. The first group extends the vocabulary for describing formatting properties of text by adding elements for specifying text effects such as shadow, glow, reflection, and also by adding elements for specifying typographical properties such as ligatures or how numeral spacing is displayed. See section 2.2.1 for more information.

The second group extends the settings that are applied to a word processing document by adding two settings to govern how images are saved, and two settings used when the document is authored by multiple authors. See section 2.2.2 for more information.

The third group of extensions provides for specifying four more kinds of structured document tags and altering the appearance of structured document tags. See section 2.2.3 for more information.

The fourth group of extensions specifies three additional attributes to appear on paragraph, section, or table rows. These attributes provide for uniquely identifying paragraphs or table rows within a document part, or provide information about presence of spelling mistakes within a paragraph, or provide formatting information for the layout of footnotes in a section. See section 2.2.4 for more information.

The fifth group specifies eight new elements that can be used when conflicting edits are present in a document that is authored by multiple authors. See section 2.2.5 for more information.

The sixth group specifies a new attribute to appear on picture and embedded objects to provide an identifier for those objects. See section 2.2.6 for more information.

Section 2.2.7 specifies a new value that extends the types of calendars that can be used in a word processing document.

Section 2.2.8 specifies a new element for specifying formatting information for the layout of footnotes in a document section. See section 2.5.1.12 for more information.

Section 2.3 specifies an extension of the set of values to be used when specifying compatibility settings of the document. Section 2.4 specifies an extension of the set of values to be used when specifying numbering formats.

The extensions specified in this format are integrated into ISO/IEC-29500 by means of the Markup Compatibility and Extensibility features as specified by ISO/IEC-29500. Specifically, the Ignorable attribute and the AlternateContent element are used to maintain compatibility with ISO/IEC-29500 implementations when integrating the extensions from this format. Using these extensions as specified in this document will result in a word processing document conformant to ISO/IEC-29500.

1.4 Relationship to Protocols and Other Structures

The structures described here are incorporated into word processing documents as described in [ISO/IEC29500-1:2016] using the Markup Compatibility and Extensibility features as described in [ISO/IEC29500-3:2015]. The global elements specified in this format appear as optional child

    12 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

elements of certain elements described in [ISO/IEC29500-1:2016] as described in section 2.2 of this document.

The global attributes specified in this format appear as optional attributes on certain elements described in [ISO/IEC29500-1:2016] as described in section 2.2 of this document.

Some of the elements, attributes, simple types and complex types here also refer to complex or simple types described in [ISO/IEC29500-1:2016].

1.5 Applicability Statement

This document specifies a set of structures to extend the XML vocabulary of ISO/IEC-29500 word- processing documents. The extensions specified in this document allow for expressing additional document content and properties, and are not applicable as a stand-alone file format. Each structure specified in this document is integrated with ISO/IEC-29500 word-processing documents in a particular way, as specified at the description of that structure. All structures are integrated into word processing documents in a way that maintains compatibility with ISO/IEC-29500 implementations.

The extensions specified in this document do not require any other extensions to be used, and do not prohibit any other extensions from being used in the same document.

1.6 Versioning and Localization

None.

1.7 Vendor-Extensible Fields

None.

    13 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

2 Structures

2.1 Part Enumerations

2.1.1 stylesWithEffects

This part<1> stores a copy of the Style Definitions part<2>. As with the Style Definitions part, a package MUST NOT contain more than two stylesWithEffects parts. See [ISO/IEC29500-1:2016] section 11.3.12 for details on the Style Definitions part.

2.1.2 commentsExtended

This part<3> contains additional information about each comment in the document described by the comments part. See [ISO/IEC29500-1:2016] section 11.3.2 for details on the comments part.

2.1.3 people

This part<4> contains contact information about each person who has authored a comment or revision in the current document.

2.1.4 commentsIds

This part<5> contains additional identification information about each comment in the document described by the comments part. See [ISO/IEC29500-1:2016] section 11.3.2 for details on the comments part.

2.1.5 commentsExtensible

This part<6> contains additional information about each comment in the document described by the comments part. See [ISO/IEC29500-1:2016] section 11.3.2 for details on the comments part.

2.2 Extensions

This section specifies the elements from [ISO/IEC29500-1:2016] that are extended by this format. Either the Ignorable attribute ([ISO/IEC29500-3:2015] section 7.2), AlternateContent element ([ISO/IEC29500-3:2015] section 7.5), or extLst element (section 2.9.3.2) MUST be used to maintain compatibility with [ISO/IEC29500-1:2016] implementations.

2.2.1 rPr Extensions

Any rPr element specified in [ISO/IEC29500-1:2016] section 17.3.2.28 is extended by the addition of one or more of the following elements: glow, shadow, reflection, textOutline, textFill, scene3d, props3d, ligatures, numForm, numSpacing, stylisticSets, cntxtAlts. To maintain compatibility with ISO/IEC-29500 implementations, the element’s namespace prefix MUST be specified in an Ignorable attribute ([ISO/IEC29500-3:2015] section 7.2).

2.2.2 Settings Extensions

The Settings element ([ISO/IEC29500-1:2016] section 17.15.1.78) is extended by the addition of one or more of the following elements: chartTrackingRefBased (section 2.5.1.2), docId (section 2.6.1.14), docId (section 2.5.1.7), conflictMode (section 2.6.1.7), discardImageEditingData (section 2.6.1.13), defaultImageDpi (section 2.6.1.12). To maintain compatibility with ISO/IEC-

14 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

29500 implementations, the element’s namespace prefix MUST be specified in an Ignorable attribute ([ISO/IEC29500-3:2015] section 7.2).

2.2.3 sdtPr Extensions

Any sdtPr element specified in [ISO/IEC29500-1:2016] section 17.5.2.38 is extended by the addition of one of the following elements: entityPicker, checkbox, repeatingSection, repeatingSectionItem, appearance, color, dataBinding, webExtensionsLinked, webExtensionCreated. To maintain compatibility with ISO/IEC-29500 implementations, the element’s namespace prefix MUST be specified in an Ignorable attribute ([ISO/IEC29500-3:2015] section 7.2).

2.2.4 p and tr Extensions

Any p element (as specified in [ISO/IEC29500-1:2016] section 17.3.1.22) or tr element (specified in [ISO/IEC29500-1:2016] section 17.4.78) is extended by the addition of any of the following attributes: paraId, textId. Any p element (as specified in [ISO/IEC29500-1:2016] section 17.3.1.22) is extended by the addition of the following attribute: noSpellErr. To maintain compatibility with ISO/IEC-29500 implementations, the attribute’s namespace prefix MUST be specified in an Ignorable attribute ([ISO/IEC29500-3:2015] section 7.2).

2.2.5 Conflict Extensions

Any element specified in [ISO/IEC29500-1:2016] that can contain an ins element (as specified in [ISO/IEC29500-1:2016] section 17.13.5.18) or a del element (as specified in [ISO/IEC29500-1:2016] section 17.13.5.14) is extended by the addition of one or more of each of the following elements: conflictIns, conflictDel. To maintain compatibility with ISO/IEC-29500 implementations, the element’s namespace prefix MUST be specified in an Ignorable attribute ([ISO/IEC29500-3:2015] section 7.2).

Any element specified in [ISO/IEC29500-1:2016] as a parent of an ins element (as specified in [ISO/IEC29500-1:2016] section 17.13.5.16, section 17.13.5.17, or section 17.13.5.20) or as a parent of a del element (as specified in [ISO/IEC29500-1:2016] section 17.13.5.12, section 17.13.5.13, or section 17.13.5.15) is extended by the addition of one or more of each of the following elements: conflictIns, conflictDel. To maintain compatibility with ISO/IEC-29500 implementations, the element’s namespace prefix MUST be specified in an Ignorable attribute ([ISO/IEC29500-3:2015] section 7.2).

Any element specified in [ISO/IEC29500-1:2016] as a parent of a customXmlDelRangeEnd (as specified in [ISO/IEC29500-1:2016] section 17.13.5.4) element, or a parent of a customXmlDelRangeStart (as specified in [ISO/IEC29500-1:2016] section 17.13.5.5) element, or a parent of a customXmlInsRangeEnd (as specified in [ISO/IEC29500-1:2016] section 17.13.5.6), or a parent of a customXmlInsRangeStart (as specified in [ISO/IEC29500-1:2016] section 17.13.5.7) is extended by the addition of one or more of each of the following elements: customXmlConflictInsRangeStart, customXmlConflictInsRangeEnd, customXmlConflictDelRangeStart, or customXmlConflictDelRangeEnd. To maintain compatibility with ISO/IEC-29500 implementations, the element’s namespace prefix MUST be specified in an Ignorable attribute ([ISO/IEC29500- 3:2015] section 7.2).

2.2.6 Pict and Object Extensions

The object element specified in [ISO/IEC29500-1:2016] section 17.3.3.19 and the pict element specified in [ISO/IEC29500-4:2016] section 14.6.1 are extended by the addition of the anchorId attribute. To maintain compatibility with ISO/IEC-29500 implementations, the attribute’s namespace prefix MUST be specified in an Ignorable attribute ([ISO/IEC29500-3:2015] section 7.2).

    15 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

2.2.7 Calendar Type Extensions

The simple type ST_CalendarType specified in [ISO/IEC29500-1:2016] section 22.9.2.1 is extended by the addition of the "umalqura" value to the enumeration. This value specifies that the Um Al-Qura lunar calendar as described by the Kingdom of Saudi Arabia, King Abdulaziz City for Science and Technology (KACST) MUST be used. To maintain compatibility with ISO/IEC-29500, the value MUST be specified in an AlternateContent element ([ISO/IEC29500-3:2015] section 7.5) with a fallback to the "hijri" calendar type.

2.2.8 sectPr Extensions

Any sectPr element specified in [ISO/IEC29500-1:2016] section 17.6.18 is extended by the addition of the footnoteColumns element (section 2.5.1.8).<7> To maintain compatibility with ISO/IEC- 29500 implementations, the element’s namespace prefix MUST be specified in an Ignorable attribute ([ISO/IEC29500-3:2015] section 7.2).

2.2.9 pPr Extensions

Any pPr element specified in [ISO/IEC29500-1:2016] section 17.7.5.2 is extended by the addition of the following element; collapsed.<8> To maintain compatibility with ISO/IEC-29500 implementations, the element’s namespace prefix MUST be specified in an Ignorable attribute ([ISO/IEC29500- 3:2015] section 7.2).

2.2.10 Numbering Definition Extensions

The abstractNum element specified in [ISO/IEC29500-1:2016] section 17.9.1 is extended by the addition of the restartNumberingAfterBreak attribute (section 2.5.2.1).<9> To maintain compatibility with ISO/IEC-29500 implementations, the prefix of the attribute namespace MUST be specified in an Ignorable attribute ([ISO/IEC29500-3:2015] section 7.2).

2.2.11 r Extensions

The r element specified in [ISO/IEC29500-1:2016] section 17.3.2.25 is extended by the addition of the symEx element (section 2.7.1.1).<10> To maintain compatibility with ISO/IEC-29500 implementations, the prefix of the element namespace MUST be specified in an Ignorable attribute ([ISO/IEC29500-3:2015] section 7.2).

2.2.12 dataBinding Extensions

The databinding element specified in [ISO/IEC29500-1:2016] section 17.5.2.6 is extended by the addition of the storeItemChecksum attribute (section 2.11.2.1).<11> To maintain compatibility with ISO/IEC29500 implementations, the prefix of the attribute namespace MUST be specified in an Ignorable attribute ([ISO/IEC29500-3:2015] section 7.2).

2.2.13 commentsExtensible Extensions

The extLst (section 2.9.3.2) child element of the commentExtensible (section 2.10.3.1) element is extended by the addition of a new child ext element (section 2.9.3.1) whose structure is specified in the following table.

Ext URI Child element {CE6994B0-6A32-4C9F-8C6B-6E91EDA988CE} reactions¹¹ (as specified in [MS-OREACTXML] section 2.1.1.1)

    16 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

2.3      compatSetting elements

This section specifies compatibility settings that use the compatSetting element, as specified in
[ISO/IEC29500-1:2016] section 17.15.3.4.

2.3.1    overrideTableStyleFontSizeAndJustification

A compatSetting element whose name attribute has the value
"overrideTableStyleFontSizeAndJustification" and whose uri attribute has the value
"http://schemas.microsoft.com/office/word" specifies how the style hierarchy of the document is
evaluated.

If this value is true, then the style hierarchy of the document is evaluated as specified in
[ISO/IEC29500-1:2016] section 17.7.2.

If this value is false, which is the default, then the following additional rules apply:

 If the default paragraph style (as specified in [ISO/IEC29500-1:2016] section 17.7.4.17) specifies
        a font size of 11pt or 12pt, then that setting will not override the font size specified by the table
        style for paragraphs in tables.

 If the default paragraph style (as specified in [ISO/IEC29500-1:2016] section 17.7.4.17) specifies
        a justification of left, then that setting will not override the justification specified by the table style
        for paragraphs in tables.

Attributes and corresponding values for this element are listed in the following table.

 Attribute                       Value

 name                            overrideTableStyleFontSizeAndJustification

 uri                             http://schemas.microsoft.com/office/word

 val                             An ST_OnOff attribute that specifies whether to apply the additional preceding
                                 rules when determining the font size and justification of text within tables.

2.3.2 doNotFlipMirrorIndents

A compatSetting element whose name attribute has the value "doNotFlipMirrorIndents" and whose uri attribute has the value "http://schemas.microsoft.com/office/word" specifies whether the values of the inside attributes (start, startChars, left, and leftChars) and outside attributes (end, endChars, right, and rightChars) of the ind element (as specified in [ISO/IEC29500-1:2016] section 17.3.1.12) are swapped when displaying paragraphs containing a mirrorIndents element (as specified in [ISO/IEC29500-1:2016] section 17.3.1.18). By default, these values are not swapped.

Attributes and corresponding values for this element are listed in the following table.

Attribute Value

name doNotFlipMirrorIndents

uri http://schemas.microsoft.com/office/word

val An ST_OnOff attribute that specifies whether to swap indentation values when displaying paragraphs.

                                     17 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

2.3.3 enableOpenTypeFeatures

A compatSetting element whose name attribute has the value "enableOpenTypeFeatures" and whose uri attribute has the value "http://schemas.microsoft.com/office/word" specifies whether [ISO/IEC-14496-22] features such as kerning (see [ISO/IEC29500-1:2016] section 17.3.2.19), ligatures, contextual alternates, stylistic sets, number spacing, and number formatting are to be used when displaying the font. By default, these features are disabled.

Attributes and corresponding values for this element are listed in the following table.

Attribute Value

name enableOpenTypeFeatures

uri http://schemas.microsoft.com/office/word

val An ST_OnOff attribute that specifies whether the preceding features are to be used when displaying the font.

2.3.4 differentiateMultirowTableHeaders

A compatSetting element<12> whose name attribute has the value "differentiateMultirowTableHeaders" and whose uri attribute has the value "http://schemas.microsoft.com/office/word" specifies formatting information for the layout and display of multi-row table headers.

If the value of val is false, then conditional formatting of table rows does not apply to multi-row table headers (as specified in [ISO/IEC29500-1:2016] sections 17.4.7, 17.4.8, 17.4.50, and 17.7.6).

If the value of val is true, then the conditional formatting of table row headers does apply separately to multi-row table headers (as specified in [ISO/IEC29500-1:2016] sections 17.4.7, 17.4.8, 17.4.50, and 17.7.6).

The value of val is false by default.

Attributes and corresponding values for this element are listed in the following table.

Attribute Value name differentiateMultirowTableHeaders uri http://schemas.microsoft.com/office/word val An ST_OnOff attribute that specifies the formatting method to use as specified above.

2.3.5 compatibilityMode

A compatSetting element whose name attribute has the value "compatibilityMode" and whose uri attribute has the value "http://schemas.microsoft.com/office/word" specifies the feature set in use when the document was last saved.

Attributes and corresponding values for this element are listed in the following table.

                           18 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Attribute Value

name compatibilityMode

uri http://schemas.microsoft.com/office/word

val An ST_UnsignedDecimalNumber (as specified in [ISO/IEC29500-1:2016] section 22.9.2.16) that specifies the feature set to use when editing the document. Valid values and their meanings are:

          11: Use features specified in [MS-DOC].

          12: Use word processing features specified in [ECMA-376]. This is the default.

          14: Use word processing features specified in [ISO/IEC29500-1:2016] and
          [ISO/IEC29500-4:2016] as well as those specified in this document with the
          exception of the features defined by the following elements and/or parts;
          commentsExtended (section 2.1.2), people (enumeration) (section 2.1.3),
          collapsed (section 2.5.1.3), docId (section 2.5.1.7), repeatingSection
          (section 2.5.1.10), repeatingSectionItem (section 2.5.1.11),
          chartTrackingRefBased (section 2.5.1.2), commentsEx (section 2.5.1.5),
          people (element) (section 2.5.1.9), color (section 2.5.1.4), dataBinding
          (section 2.5.1.6), appearance (section 2.5.1.1), webExtensionLinked
          (section 2.5.1.13), webExtensionCreated (section 2.5.1.12).

          15: Use word processing features specified in [ISO/IEC29500-1:2016] and
          [ISO/IEC29500-4:2016] as well as those specified in this document.

An application MAY<13> ignore a compatSetting with a val attribute whose value is 15.

2.3.6 allowTextAfterFloatingTableBreak

A compatSetting element<14> whose name attribute has the value "allowTextAfterFloatingTableBreak" and whose uri attribute has the value "http://schemas.microsoft.com/office/word" specifies information about the layout of document content which follows a floating table that breaks across pages.

If the value of val is false, which is the default, then the document content that follows the floating table is added after the end of the table.

If the value of val is true, then the document content that follows the floating table can be added to the same pages as the table. The content follows the usual page breaking rules and can flow around the table.

Attributes and corresponding values for this element are listed in the following table.

Attribute Value

name allowTextAfterFloatingTableBreak

uri http://schemas.microsoft.com/office/word

val An ST_OnOff attribute that specifies the formatting method to use as specified above.

                             19 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

2.3.7    allowHyphenationAtTrackBottom

A compatSetting element<15> whose name attribute has the value
"allowHyphenationAtTrackBottom" and whose uri attribute has the value
"http://schemas.microsoft.com/office/word" specifies information about the layout of documents in
which a hyphenated word ends a page or column.

If the value of val is false, which is the default, then useWord2013TrackBottomHyphenation
(section 2.3.8) controls the layout of the document.

If the value of val is true, then a line that ends with a hyphenated word is allowed to be the last line
in a page or column.

Attributes and corresponding values for this element are listed in the following table.

 Attribute          Value

 name               allowHyphenationAtTrackBottom

 uri                http://schemas.microsoft.com/office/word

 val                An ST_OnOff attribute that specifies whether a hyphenated word is allowed to
                    end a page or column.

2.3.8 useWord2013TrackBottomHyphenation

A compatSetting element<16> whose name attribute has the value "useWord2013TrackBottomHyphenation" and whose uri attribute has the value "http://schemas.microsoft.com/office/word" specifies information about the layout of documents in which a hyphenated word ends a page or column.

If the value of val is false, which is the default, then such a hyphenated word is displayed on the following page or column but the rest of the line that contained it is displayed on the previous page.

If the value of val is true, then the line containing such a hyphenated word is displayed on the following page or column.

If useWord2013TrackBottomHyphenation is not present, then the line containing such a hyphenated word is displayed on the following page or column as though useWord2013TrackBottomHyphenation were present with val set to true.

If allowHyphenationAtTrackBottom (section 2.3.7) is set to true, useWord2013TrackBottomHyphenation MUST be ignored.

Attributes and corresponding values for this element are listed in the following table.

 Attribute          Value

 name               useWord2013TrackBottomHyphenation

 uri                http://schemas.microsoft.com/office/word

 val                An ST_OnOff attribute that specifies whether the method to use to avoid
                    having hyphenated word at the bottom of page or column.





                        20 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

2.3.9 usePre2018iOSMacLayout

A compatSetting element whose name attribute has the value "usePre2018iOSMacLayout" and whose uri attribute has the value "http://schemas.microsoft.com/office/word" specifies information about the layout of documents based on old MacOS font metrics, which are different from the Windows font metrics.

If the value of val is false, then the Windows font metrics will be used on both Windows and Mac.

If the value of val is true, then the pre-2025 Mac font metrics will be used on both Windows and Mac.

If usePre2018iOSMacLayout is not present, then it is set based on the current platform.

Attributes and corresponding values for this element are listed in the following table.

Attribute Value

uri http://schemas.microsoft.com/office/word

val An ST_OnOff attribute that specifies information about the layout of documents based on old MacOS font metrics, which are different from the Windows font metrics.

2.4 numFmt Extensions

This section specifies additional values to be used for the format attribute of the numFmt element, as specified in [ISO/IEC29500-1:2016] section 17.9.17. The following two tables specify the strings used for the format attribute.

Each row in the first table specifies a string, along with a corresponding value from the simple type ST_NumberFormat, as specified in [ISO/IEC29500-1:2016] section 17.18.59. If the value of the format attribute is equal to the string in the left column, the numbering format applied is specified by the value in the right column, as specified in [ISO/IEC29500-1:2016] section 17.18.59.

String Attribute value

U+FF71, U+FF72, U+FF73, ... aiueo

U+30A2, U+30A4, U+30A6, ... aiueoFullWidth

U+0623, U+0628, U+062C, ... arabicAbjad

U+0623, U+0628, U+062A, ... arabicAlpha

One, Two, Three, ... cardinalText

U+002A, U+2020, U+2021, ... chicago

U+4E00, U+5341, U+4E00U+25CBU+25CB(U+7B80), ... chineseCounting

U+4E00, U+5341, U+4E00U+767E(U+7B80), ... chineseCountingThousand

U+58F9, U+8D30, U+53C1, ... chineseLegalSimplified

U+3131, U+3134, U+3137, ... chosung

U+0031 decimal

U+2460, U+2461, U+2462, ... decimalEnclosedCircle

    21 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

String Attribute value

U+2488, U+2489, U+248A, ... decimalEnclosedFullstop

U+2474, U+2475, U+2476, ... decimalEnclosedParen

U+FF11, U+FF12, U+FF13, ... decimalFullWidth

U+0030U+0031, U+0030U+0032, U+0030U+0033, ... decimalZero

U+AC00, U+B098, U+B2E4, ... ganada

U+05D0, U+05D9, U+05E7, ... hebrew1

U+05D0, U+05D1, U+05D2, ... hebrew2

U+0031, U+0041, U+0042, ... hex

U+0905, U+0906, U+0907, ... hindiConsonants

U+090FU+0915, U+0926U+094B, U+0924U+0940U+0928, ... hindiCounting

U+0967, U+0968, U+0969, ... hindiNumbers

U+0915, U+0916, U+0917, ... hindiVowels

U+4E00, U+4E00U+3007, U+4E00U+3007U+3007, ... ideographDigital

U+3220, U+3221, U+3222, ... ideographEnclosedCircle

U+58F9, U+8CB3, U+53C3, ... ideographLegalTraditional

U+7532, U+4E59, U+4E19, ... ideographTraditional

U+5B50, U+4E11, U+5BC5, ... ideographZodiac

U+7532U+5B50, U+4E59U+4E11, U+4E19U+5BC5, ... ideographZodiacTraditional

U+FF72, U+FF9B, U+FF8A, ... iroha

U+30A4, U+30ED, U+30CF, ... irohaFullWidth

U+4E00, U+4E8C, U+4E09, ... japaneseCounting

U+4E00, U+4E8C, U+4E09, U+4E07, ... japaneseDigitalTenThousand

U+58F1, U+5F10, U+53C2, ... japaneseLegal

U+C77C, U+C774, U+C0BC, ... koreanCounting

U+C77C, U+C77CU+C601, U+C77CU+C601U+C601, ... koreanDigital

U+4E00, U+4E00U+96F6, U+4E00U+96F6U+96F6, ... koreanDigital2

U+D558U+B098, U+B458, U+C14B, ... koreanLegal

U+0061 lowerLetter

U+0069 lowerRoman

[Empty string] none

  • 1 -, - 2 -, - 3 -, ... numberInDash

1st, 2nd, 3rd, ... ordinal

    22 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

String Attribute value

First, Second, Third, ... ordinalText

U+0430, U+0431, U+0432, ... russianLower

U+0410, U+0411, U+0412, ... russianUpper

U+4E00, U+5341, U+4E00U+25CBU+25CB(U+7E41), ... taiwaneseCounting

U+4E00, U+5341, U+4E00U+767E(U+7E41), ... taiwaneseCountingThousand

U+4E00, U+4E00U+25CB, U+4E00U+25CBU+25CB(U+7E41), ... taiwaneseDigital

U+0E2BU+0E19U+0E36U+0E48U+0E07, U+0E2AU+0E2DU+0E07, thaiCounting U+0E2AU+0E32U+0E21, ...

U+0E01, U+0E02, U+0E04, ... thaiLetters

U+0E51, U+0E52, U+0E53, ... thaiNumbers

U+0041 upperLetter

U+0049 upperRoman

U+006DU+00F4U+0323U+0074, U+0068U+0061U+0069, vietnameseCounting U+0062U+0061, ...

Furthermore, the following table specifies the sequence for additional values of the format attribute.

String                          Description

U+0041, U+00C7, U+011C, ...     Specifies that the sequence MUST consist of uppercase Turkish
                                alphabet.



                                To determine the text that is displayed for any value, this sequence
                                specifies a set of characters that represent positions 1–29 and then
                                those same characters are combined with each other to construct
                                the remaining values.



                                The set of characters used by this numbering format for values 1–29
                                is U+0041-U+0043, U+00C7, U+0044-U+0047, U+011E, U+0048,
                                U+0049, U+0130, U+004A-U+004F, U+00D6, U+0050, U+0052,
                                U+0053, U+015E, U+0054, U+0055, U+00DC, U+0056, U+0059,
                                U+005A, respectively.



                                For values greater than 29, the text displayed MUST be constructed
                                as follows:



1.   Repeatedly subtract the size of the set (29) from the value
     until the result is equal to or less than the size of the set.

2.   The remainder determines which character to use from the
     preceding set, and that character is written once and then


                                    23 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

repeated the number of times the size of the set was subtracted from the original value.

U+0061, U+00E7, U+011D, ... Specifies that the sequence MUST consist of lowercase Turkish alphabet.

                            To determine the text that is displayed for any value, this sequence
                            specifies a set of characters that represent positions 1–29 and then
                            those same characters are combined with each other to construct
                            the remaining values.



                            The set of characters used by this numbering format for values 1–29
                            is U+0061-U+0063, U+00E7, U+0064-U+0067, U+011F, U+0068,
                            U+0131, U+0069-U+006F, U+00F6, U+0070, U+0072, U+0073,
                            U+015F, U+0074, U+0075, U+00FC, U+0076, U+0079, U+007A,
                            respectively.



                            For values greater than 29, the text displayed MUST be constructed
                            as follows:
  1. Repeatedly subtract the size of the set (29) from the value until the result is equal to or less than the size of the set.

  2. The remainder determines which character to use from the preceding set, and that character is written once and then repeated the number of times the size of the set was subtracted from the original value.

U+0410, U+0419, U+041A, ... Specifies that the sequence MUST consist of uppercase Bulgarian alphabet.

                            To determine the text that is displayed for any value, this sequence
                            specifies a set of characters that represent positions 1–29 and then
                            those same characters are combined with each other to construct
                            the remaining values.



                            The set of characters used by this numbering format for values 1–29
                            is U+0410-U+042A, U+042E, U+042F, respectively.



                            For values greater than 29, the text displayed MUST be constructed
                            as follows:



                            1. Repeatedly subtract the size of the set (29) from the value



                                24 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

 until the result is equal to or less than the size of the set.
  1. The remainder determines which character to use from the preceding set, and that character is written once and then repeated the number of times the size of the set was subtracted from the original value.

U+0430, U+0439, U+043A, ... Specifies that the sequence MUST consist of lowercase Bulgarian alphabet.

                            To determine the text that is displayed for any value, this sequence
                            specifies a set of characters that represent positions 1–29 and then
                            those same characters are combined with each other to construct
                            the remaining values.



                            The set of characters used by this numbering format for values 1–29
                            is U+0430-U+044A, U+044E, U+044F, respectively.



                            For values greater than 29, the text displayed MUST be constructed
                            as follows:
  1. Repeatedly subtract the size of the set (29) from the value until the result is equal to or less than the size of the set.

  2. The remainder determines which character to use from the preceding set, and that character is written once and then repeated the number of times the size of the set was subtracted from the original value.

U+0391, U+0392, U+0393, ... Specifies that the sequence MUST consist of uppercase Greek alphabet.

                            This sequence specifies a set of characters that represent positions
                            1-9 (U+0391-U+0395, U+03A3U+03A4, U+0396-U+0398), a set of
                            characters that represent 10, 20, 30, …, 90 (U+0399-U+03A0,
                            U+03DE), and a set of characters that represent 100, 200, 300, …,
                            900 (U+03A1, U+03A3-U+03A9, U+03E0).



                            To determine the text that is displayed for values between 1 and
                            999, choose the appropriate character from the preceding sets for
                            the units, the tens, and the hundreds position of the value. Write the
                            hundreds character (if present), then the tens (if present) to the
                            right of the hundreds character, and finally the units (if present) to
                            the right of the tens character.



                                  To determine the text that is displayed for values between 1000 and
                                  9999, write the character U+002C, followed to the right by the
                                  appropriate character from the units set (U+0391-U+0395,

                                      25 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

U+03A3U+03A4, U+0396-U+0398) for the thousands position. Then use the preceding paragraph to determine the hundreds, tens, and units. Position those characters to the right of the thousands position.

For values larger than 9999, repeatedly subtract 9999 until the value is smaller than 9999. Use the preceding paragraphs to determine the text corresponding to the resulting value.

U+03B1, U+03B2, U+03B3, ... Specifies that the sequence MUST consist of lowercase Greek alphabet.

                            This sequence specifies a set of characters that represent positions
                            1-9 (U+03B1-U+03B5, U+03C3U+03C4, U+03B6-U+03B8), a set of
                            characters that represent 10, 20, 30, …, 90 (U+03B9-U+03C0,
                            U+03DF), and a set of characters that represent 100, 200, 300, …,
                            900 (U+03C1, U+03C3-U+03C9, U+03E1).



                            To determine the text that is displayed for values between 1 and
                            999, choose the appropriate character from the preceding sets for
                            the units, the tens, and the hundreds position of the value. Write the
                            hundreds character (if present), then the tens (if present) to the
                            right of the hundreds character, and finally the units (if present) to
                            the right of the tens character.



                            To determine the text that is displayed for values between 1000 and
                            9999, write the character U+002C, followed by the appropriate
                            character from the units set (U+0391-U+0395, U+03A3U+03A4,
                            U+0396-U+0398) for the thousands position. Then use the
                            preceding paragraph to determine the hundreds, tens, and units.
                            Position those characters to the right of the thousands position.



                            For values larger than 9999, repeatedly subtract 9999 until the value
                            is smaller than 9999. Use the preceding paragraphs to determine the
                            text corresponding to the resulting value.

001, 002, 003, ... Specifies that the sequence MUST consist of Arabic numbering with up to two zeros added to numbers 1 through 99.

                            To determine the text that is displayed for any value, this sequence
                            specifies a set of paired characters (zero followed by one or two
                            additional symbols) that represent positions 1–99, and then those
                            same characters are combined with each other to construct the
                            remaining values.



                                  The set of characters used by this numbering format for values 0–9
                                  is U+0030–U+0039. For values greater than the size of the set, the
                                  number MUST be constructed by following these steps:

                                  1. Divide the value by 10 and write the symbol that represents

                                      26 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

 the remainder.
  1. Divide the quotient of the previous division by 10 and write the symbol, which represents the remainder, to the left of the existing position.

  2. Repeat step 2 until the remaining value is equal to zero.

0001, 0002, 0003, ... Specifies that the sequence MUST consist of Arabic numbering with up to three zeros added to numbers 1 through 999.

                      To determine the text that is displayed for any value, this sequence
                      specifies a set of paired characters (zero followed by up to three
                      additional symbols) that represent positions 1–999, and then those
                      same characters are combined with each other to construct the
                      remaining values.



                      The set of characters used by this numbering format for values 0–9
                      is U+0030–U+0039. For values greater than the size of the set, the
                      number MUST be constructed by following these steps:

                       1.   Divide the value by 10 and write the symbol that represents
                            the remainder.

                       2.   Divide the quotient of the previous division by 10 and write the
                            symbol, which represents the remainder, to the left of the
                            existing position.

                       3.   Repeat step 2 until the remaining value is equal to zero.

00001, 00002, 00003, ... Specifies that the sequence MUST consist of Arabic numbering with up to four zeros added to numbers 1 through 9999.

                         To determine the text that is displayed for any value, this sequence
                         specifies a set of paired characters (zero followed by up to three
                         additional symbols) that represent positions 1–9999, and then those
                         same characters are combined with each other to construct the
                         remaining values.



                         The set of characters used by this numbering format for values 0–9
                         is U+0030–U+0039. For values greater than the size of the set, the
                         number MUST be constructed by following these steps:

                          1.   Divide the value by 10 and write the symbol that represents
                               the remainder.

                          2.   Divide the quotient of the previous division by 10 and write the
                               symbol, which represents the remainder, to the left of the
                               existing position.

                          3.   Repeat step 2 until the remaining value is equal to zero.





                                   27 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

2.5 http://schemas.microsoft.com/office/word/2012/wordml

2.5.1 Elements

2.5.1.1 appearance

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The appearance global element<17> is a CT_SdtAppearance (section 2.5.3.7) element that specifies the appearance of a structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2).

See section 2.2.3 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="appearance" type="CT_SdtAppearance"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.1.2 chartTrackingRefBased

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The chartTrackingRefBased global element<18> is a CT_OnOff (as specified in [ISO/IEC29500- 1:2016] section A.1) element that specifies how the datapoint properties ([MS-ODRAWXML] section 2.8.3.1) and datalabels ([MS-ODRAWXML] section 2.2.1.2) in all charts ([ISO/IEC29500-1:2016] section 21.2) in this document behave.

Value        Meaning

 True    Datapoint properties ([MS-ODRAWXML] section 2.8.3.1) and datalabels ( [MS-ODRAWXML] section
         2.2.1.2) in all charts ([ISO/IEC29500-1:2016] section 21.2) in this document follow their reference.

         Datapoint properties ([MS-ODRAWXML] section 2.8.3.1) and datalabels ([MS-ODRAWXML] section
 False   2.2.1.2) in all charts ([ISO/IEC29500-1:2016] section 21.2) in this document follow their position in
         the chart.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="chartTrackingRefBased" type="w12:CT_OnOff"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.1.3 collapsed

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

             28 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

The collapsed global element<19> is a CT_OnOff (as specified in [ISO/IEC29500-1:2016] section A.1) element that, when added to a paragraph (pPr element as specified in [ISO/IEC29500-1:2016] section 17.7.5.2), specifies the appearance of subsequent paragraphs.

When a collapsed element is added to a paragraph (pPr element as specified in [ISO/IEC29500- 1:2016] section 17.7.5.2) of a particular heading level and its value is "true", "on", or "1", immediately subsequent paragraphs with a higher heading level number appear collapsed when the document is opened.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="collapsed" type="w12:CT_OnOff"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.1.4 color

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The color global element<20> is a CT_Color (as specified in [ISO/IEC29500-1:2016] section A.1) element that specifies the color on which to base the visual elements of a structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2).

See section 2.2.3 for how this element integrates with [ISO/IEC29500-1:2016].

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="color" type="w12:CT_Color"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.1.5 commentsEx

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The commentsEx global element<21> is a CT_CommentsEx (section 2.5.3.2) element that specifies the additional information for all of the comments defined in the current document. It is the root element of the commentsExtended part of a WordprocessingML document.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="commentsEx" type="CT_CommentsEx"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.1.6 dataBinding

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The dataBinding global element<22> is a CT_DataBinding (as specified in [ISO/IEC29500-1:2016] section A.1) element that specifies the information used to establish a mapping between the parent

    29 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2) and an XML element stored within a Custom XML Data part in the current WordprocessingML document.

If the parent structured document tag is not of type rich text (as specified in [ISO/IEC29500-1:2016] section 17.5.2.26) then this behaves like a dataBinding (as specified in [ISO/IEC29500-1:2016] section 17.5.2.6) element, otherwise the data stored in the XML element will be an escaped string comprised of a flattened WordprocessingML document representing the formatted data in the structured document tag range.

See section 2.2.3 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="dataBinding" type="w12:CT_DataBinding"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.1.7 docId

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The docId global element<23> is a CT_Guid (as specified in section 2.5.3.3) element that specifies a unique identifier for a set of documents derived from a common source. The possible values for this attribute are defined by the ST_Guid simple type (as specified in section 2.5.4.1). See section 2.2.2 for how this element integrates with [ISO/IEC29500-1:2016].

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="docId" type="CT_Guid"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.1.8 footnoteColumns

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The footnoteColumns global element<24> is a CT_DecimalNumber (as specified by [ISO/IEC29500-1:2016] section A.1) element that, when added to a document section (sectPR element, as specified in [ISO/IEC29500-1:2016] section 17.6.18), specifies the formatting of the footnotes area of the page containing that section. If the element exists and is non-zero, then the footnotes area is formatted with the number of columns specified. If the element does not exist, or is zero, then the footnotes area of the page is formatted with a number of columns based on the number of columns on the displayed page.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="footnoteColumns" type="w12:CT_DecimalNumber"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

    30 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

2.5.1.9 people

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The people global element<25> is a CT_People (section 2.5.3.4) element that specifies contact information for each person who is the author of at least one comment or revision in the current document. It is the root element of the people part (section 2.1.3).

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="people" type="CT_People"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.1.10 repeatingSection

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The repeatingSection global element<26> is a CT_SdtRepeatedSection (section 2.5.3.8) element that specifies that the parent structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2) is a container for repeated items. The parent structured document tag MUST contain only repeatingSectionItem (section 2.5.1.11) structured document tags.

If dataBinding (as specified in [ISO/IEC29500-1:2016] section 17.5.2.6) is specified and the binding results in finding XML elements, the numerical relation between the number of elements matched and the number of repeatingSectionItems (section 2.5.1.11) contained MUST be maintained.

See section 2.2.3 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="repeatingSection" type="CT_SdtRepeatedSection"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.1.11 repeatingSectionItem

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The repeatingSectionItem global element<27> is a CT_EMPTY (as specified in [ISO/IEC29500- 1:2016] section A.1) element that specifies that the parent structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2) is a repeated item. The parent structured document tag MUST be contained within a repeatingSection (section 2.5.1.10) structured document tag and MUST be either Block-Level (as specified in [ISO/IEC29500-1:2016] section 17.5.2.29), Row-Level (as specified in [ISO/IEC29500-1:2016] section 17.5.2.30), or Cell-Level (as specified in [ISO/IEC29500-1:2016] section 17.5.2.32).

See section 2.2.3 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="repeatingSectionItem" type="w12:CT_Empty"/>


    31 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.1.12 webExtensionCreated

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The webExtensionCreated global element<28> is a CT_OnOff (as specified in [ISO/IEC29500- 1:2016] section A.1) element that specifies a property of a structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2) and whose presence indicates a relationship between the structured document tag and an Office Web Extension (webExtension) (as specified in [MS- OWEXML] section 2.1.1).

If a webExtensionCreated element exists in the property set of a structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2.38) and its value is "true", "on", or "1", then the structured document tag was created by, and is bound to, at least one webExtension. By default, structured document tags are neither created by, nor bound to webExtensions.

If the property set of a structured document tag also contains a webExtensionLinked element, then that webExtensionLinked element is ignored and this webExtensionCreated element takes precedence.

See section 2.2.3 for how this element integrates with [ISO/IEC29500-1:2016].

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="webExtensionCreated" type="w12:CT_OnOff"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.1.13 webExtensionLinked

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The webExtensionLinked global element<29> is a CT_OnOff (as specified in [ISO/IEC29500- 1:2016] section A.1) element that specifies a property of a structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2) and whose presence indicates a relationship between the structured document tag and an Office Web Extension (webExtension) (as specified in [MS- OWEXML] section 2.1.1).

If a webExtensionLinked element exists in the property set of a structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2.38) and its value is "true", "on", or "1", then the structured document tag is bound to at least one webExtension. By default, structured document tags are not bound to webExtensions.

If the property set of a structured document tag also contains a webExtensionCreated element, then this webExtensionLinked element is ignored.

See section 2.2.3 for how this element integrates with [ISO/IEC29500-1:2016].

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="webExtensionLinked" type="w12:CT_OnOff"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

    32 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

2.5.2 Attributes

2.5.2.1 restartNumberingAfterBreak

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

The restartNumberingAfterBreak attribute<30> is an ST_OnOff (as specified in [ISO/IEC29500- 1:2016] section 22.9.2.7) attribute which, when applied to a Numbering Definition part, specifies that numbering will restart in the next section.

See section 2.2.10 for how this element integrates with [ISO/IEC29500-1:2016].

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this attribute.

<xsd:attribute name="restartNumberingAfterBreak" type="w12:ST_OnOff"/>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.3 Complex Types

2.5.3.1 CT_CommentEx

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

Referenced by: CT_CommentsEx

The CT_CommentEx complex type<31> specifies additional information for a single comment in the current document.

Attributes:

paraId: An ST_LongHexNumber (as specified by [ISO/IEC29500-1:2016] section 17.18.50) attribute that specifies the paraId (section 2.6.2.3) of the last paragraph in the associated comment.

paraIdParent: An ST_LongHexNumber (as specified by [ISO/IEC29500-1:2016] section 17.18.50) attribute that specifies the paraId (section 2.6.2.3) of the last paragraph in the comment to which the associated comment is a reply.

done: An ST_OnOff (as specified in [ISO/IEC29500-1:2016] section 22.9.2.7) attribute that specifies whether the associated comment is marked as done. A value of 1 specifies that a user has indicated that this comment is done. A value of 0 specifies that a user has not indicated that this comment is done. The default value for this attribute is 0.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_CommentEx"> <xsd:attribute name="paraId" type="w12:ST_LongHexNumber" use="required"/> <xsd:attribute name="paraIdParent" type="w12:ST_LongHexNumber" use="optional"/> <xsd:attribute name="done" type="w12:ST_OnOff" use="optional"/> </xsd:complexType>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

      33 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

2.5.3.2 CT_CommentsEx

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

Referenced by: commentsEx

The CT_CommentsEx complex type<32> specifies additional information for all of the comments defined in the current document.

Child Elements:

commentEx: A CT_CommentEx (section 2.5.3.1) element that specifies additional information for a single comment in the current document.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_CommentsEx"> xsd:sequence <xsd:element name="commentEx" type="CT_CommentEx" minOccurs="0" maxOccurs="unbounded"/> </xsd:sequence> </xsd:complexType>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.3.3 CT_Guid

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

Referenced by: docId

A complex type that specifies a GUID (globally unique identifier).

Attributes:

val: An ST_Guid (section 2.5.4.1) attribute that specifies the value of this complex type.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Guid"> <xsd:attribute name="val" type="ST_Guid"/> </xsd:complexType>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.3.4 CT_People

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

Referenced by: people

The CT_People complex type<33> specifies contact information for each person who is the author of at least one comment or revision in the current document.

Child Elements:

  34 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

person: A CT_Person (section 2.5.3.5) element that specifies contact information for an author of at least one comment or revision in the current document.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_People"> xsd:sequence <xsd:element name="person" type="CT_Person" minOccurs="0" maxOccurs="unbounded"/> </xsd:sequence> </xsd:complexType>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.3.5 CT_Person

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

Referenced by: CT_People

The CT_Person complex type<34> specifies contact information for an author of at least one comment or revision in the current document.

Child Elements:

presenceInfo: A CT_PresenceInfo element (section 2.5.3.6) that specifies uniquely identifying contact information for the person whose name matches the value of the author attribute of this complex type.

Attributes:

author: An ST_String (as specified in [ISO/IEC29500-1:2016] section 22.9.2.13) attribute that specifies the author name to which this person is associated. The value of this attribute MUST match the Annotation Author (as specified in [ISO/IEC29500-1:2016] sections 17.13.4.2 and 17.13.5) value of at least one comment or revision in the current document.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Person"> xsd:sequence <xsd:element name="presenceInfo" type="CT_PresenceInfo" minOccurs="0" maxOccurs="1"/> </xsd:sequence> <xsd:attribute name="author" type="w12:ST_String" use="required"/> </xsd:complexType>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.3.6 CT_PresenceInfo

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

Referenced by: CT_Person

The CT_PresenceInfo complex type<35> specifies uniquely identifying contact information for a person.

Attributes:

 35 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

providerId: An xsd:string attribute ([XMLSCHEMA2/2] section 3.2.1) that specifies the identity provider that produced the subsequent userId attribute.

userId: An xsd:string attribute ([XMLSCHEMA2/2] section 3.2.1) that specifies a unique user id for a person.

This table lists the allowed values of the providerId attribute and the corresponding meanings of the userId attribute.

Identity providerId Provider value userId value No Provider "None" Author’s name Active "AD" Active Directory Security Identifier (as specified in [MS-DTYP] section 2.4.2) Directory Windows Live "Windows A 64-bit signed decimal that uniquely identifies a user on Windows Live. ID Live" Office "AD" A string that uniquely identifies a user. It SHOULD<37> be comprised of three 365<36> individual values separated by a "::" character delimiter.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_PresenceInfo"> <xsd:attribute name="providerId" type="xsd:string" use="required"/> <xsd:attribute name="userId" type="xsd:string" use="required"/> </xsd:complexType>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.3.7 CT_SdtAppearance

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

Referenced by: appearance

The CT_SdtAppearance complex type<38> specifies the appearance of a structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2).

Attributes:

val: An ST_SdtAppearance (section 2.5.4.2) attribute that specifies the appearance of a structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2).

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_SdtAppearance"> <xsd:attribute name="val" type="ST_SdtAppearance"/> </xsd:complexType>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.3.8 CT_SdtRepeatedSection

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

                           36 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Referenced by: repeatingSection

The CT_SdtRepeatedSection complex type<39> specifies the properties of a structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2) in the form of a repeated section.

Child Elements:

sectionTitle: An optional CT_String (as specified in [ISO/IEC29500-1:2016] section A.1) element that specifies the display name of the repeated section.

doNotAllowInsertDeleteSection: A CT_OnOff (as specified in [ISO/IEC29500-1:2016] section A.1) element that specifies whether to allow the insertion of new or deletion of old repeatingSectionItems (section 2.5.1.11) contained within the structured document tag except when needed to maintain the numerical relation between the number of elements matched through data binding and the number of repeatingSectionItems (section 2.5.1.11) contained.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_SdtRepeatedSection"> xsd:sequence <xsd:element name="sectionTitle" type="w12:CT_String" minOccurs="0"/> <xsd:element name="doNotAllowInsertDeleteSection" type="w12:CT_OnOff" minOccurs="0"/> </xsd:sequence> </xsd:complexType>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.4 Simple Types

2.5.4.1 ST_Guid

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

Referenced by: CT_Guid

The ST_Guid simple type specifies a GUID, or globally unique identifier ([ISO/IEC29500-4:2016] section A.8.9).

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_Guid"> <xsd:restriction base="xsd:token"> <xsd:pattern value="{[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}}"/> </xsd:restriction> </xsd:simpleType>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.5.4.2 ST_SdtAppearance

Target namespace: http://schemas.microsoft.com/office/word/2012/wordml

Referenced by: CT_SdtAppearance

       37 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

The ST_SdtAppearance simple type<40> specifies the appearance of a structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2)

Value Meaning

    Specifies that the region encompassed by a structured document is outlined or shaded when

boundingBox visual indication of the structured document tag is needed. Any UI specific to a particular structured document tag is visible when needed.

tags Specifies that the physical characters that delimit the start and end of the structured document tag are visible as well as any UI specific to a particular structured document tag.

hidden Specifies that there is no visual indication of the structured document tag.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this
simple type.

     <xsd:simpleType name="ST_SdtAppearance">
      <xsd:restriction base="xsd:string">
       <xsd:enumeration value="boundingBox"/>
       <xsd:enumeration value="tags"/>
       <xsd:enumeration value="hidden"/>
      </xsd:restriction>
     </xsd:simpleType>

See section 5.2 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6   http://schemas.microsoft.com/office/word/2010/wordml

2.6.1  Elements

2.6.1.1 checkbox

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_SdtCheckbox element that specifies that the parent structured document tag (as specified in
[ISO/IEC29500-1:2016] section 17.5.2) is a checkbox when displayed in the document. The parent
structured document tag contents MUST contain a single character and optionally an additional
character in a deleted run (as specified in [ISO/IEC29500-1:2016] section 17.13.5.14). See section
2.2.3 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this
element.

    <xsd:element name="checkbox" type="CT_SdtCheckbox"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.2 cntxtAlts

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_OnOff element that specifies whether to display the characters using contextual alternates. (For
more information about contextual alternates, see [ISO/IEC-14496-22].) By default, text is not

           38 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

displayed using contextual alternates. See section 2.2.1 for how this element integrates with ISO/IEC- 29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="cntxtAlts" minOccurs="0" type="CT_OnOff"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.3 conflictDel

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_RunTrackChange element as specified in [ISO/IEC29500-1:2016] that specifies inline-level content that has been deleted in conflict with edits made by other users. An application MAY<41> treat the content as a tracked deletion. See section 2.2.5 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="conflictDel" type="w:CT_RunTrackChange" minOccurs="0"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.4 conflictDel

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_TrackChange element as specified in [ISO/IEC29500-1:2016] that specifies that the parent object has been deleted in conflict with edits made by other users. An application MAY<42> treat the parent as a tracked deletion. See section 2.2.5 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="conflictDel" type="w:CT_TrackChange" minOccurs="0"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.5 conflictIns

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_TrackChange element as specified in [ISO/IEC29500-1:2016] that specifies that the parent object has been inserted in conflict with edits made by other users. An application MAY<43> treat the parent as a tracked insertion. See section 2.2.5 for how this element integrates with ISO/IEC-29500- 1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

    39 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

<xsd:element name="conflictIns" type="w:CT_TrackChange" minOccurs="0"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.6 conflictIns

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_RunTrackChange element as specified in [ISO/IEC29500-1:2016] that specifies inline-level content that has been inserted in conflict with edits made by other users. An application MAY<44> treat the content as a tracked insertion. See section 2.2.5 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="conflictIns" type="w:CT_RunTrackChange" minOccurs="0"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.7 conflictMode

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_OnOff element that, when true, specifies that the user was resolving conflicting edits when the document was saved. See section 2.2.2 for how this element integrates with [ISO/IEC29500-1:2016].

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="conflictMode" type="CT_OnOff"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.8 customXmlConflictDelRangeEnd

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_Markup (as specified in [ISO/IEC29500-1:2016]) element that specifies the end of a region in which all custom XML markup has been deleted in conflict with edits made by other users. An application MAY<45> ignore this element. See section 2.2.5 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="customXmlConflictDelRangeEnd" type="w:CT_Markup"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.9 customXmlConflictDelRangeStart

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

40 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

A CT_TrackChange (as specified in [ISO/IEC29500-1:2016]) element that specifies the beginning of a region in which all custom XML markup has been deleted in conflict with edits made by other users. An application MAY<46> ignore this element. See section 2.2.5 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="customXmlConflictDelRangeStart" type="w:CT_TrackChange"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.10 customXmlConflictInsRangeEnd

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_Markup (as specified in [ISO/IEC29500-1:2016]) element that specifies the end of a region in which all custom XML markup has been inserted in conflict with edits made by other users. An application MAY<47> ignore this element. See section 2.2.5 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="customXmlConflictInsRangeEnd" type="w:CT_Markup"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.11 customXmlConflictInsRangeStart

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_TrackChange (as specified in [ISO/IEC29500-1:2016]) element that specifies the beginning of a region in which all custom XML markup has been inserted in conflict with edits made by other users. An application MAY<48> ignore this element. See section 2.2.5 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="customXmlConflictInsRangeStart" type="w:CT_TrackChange"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.12 defaultImageDpi

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

This setting is ignored by images that have dots per inch (DPI) specified by useLocalDpi (as specified in [MS-ODRAWXML] section 2.3.1.13). This setting is also ignored when doNotAutoCompressPictures (as specified in [ISO/IEC29500-1:2016] section 17.15.1.33) is set to "true".

    41 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

A CT_DefaultImageDpi element that specifies the resolution in dots per inch (DPI) at which images in the document will be saved. See section 2.2.2 for how this element integrates with ISO/IEC-29500- 1.§

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="defaultImageDpi" type="CT_DefaultImageDpi"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.13 discardImageEditingData

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_OnOff element that specifies that when true, the cropped-out areas of the images are not to be saved. Rather, the images saved are the results of applying imgProps (as specified in [MS- ODRAWXML] section 2.3.1.9) on the original images. See section 2.2.2 for how this element integrates with ISO/IEC-29500-1.

If this element is absent or if it has a value of "false", the cropped-out areas of images are saved.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="discardImageEditingData" type="CT_OnOff"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.14 docId

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_LongHexNumber element that specifies an arbitrary identifier for the context of the paragraph identifiers in the document. Values MUST be greater than 0 and less than 0x80000000. See section 2.2.2 for how this element integrates with [ISO/IEC29500-1:2016].

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="docId" type="CT_LongHexNumber"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.15 entityPicker

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_EMPTY element (as specified in [ISO/IEC29500-1:2016] section A.1) that specifies that the parent structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2) allows the user to select an instance of an external content type when displayed in the document. See section 2.2.3 for how the entityPicker element integrates with ISO/IEC-29500-1.

    42 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

The parent structured document tag MUST contain content that is valid within a text element (as specified in [ISO/IEC29500-1:2016] section 17.5.2.44), and MUST contain a dataBinding element (as specified in [ISO/IEC29500-1:2016] section 17.5.2.6).

The WordprocessingML document MUST contain a custom XML data part whose root namespace is "http://schemas.microsoft.com/office/2006/metadata/properties", and whose identifier (as specified by [ISO/IEC29500-1:2016] section 22.5.2.1) matches the value specified by the storeItemID attribute on the dataBinding element of the structured document tag containing the entityPicker element. The xpath attribute on the dataBinding element MUST specify the path to an element within that custom XML data part.

The document MUST also contain a custom XML data part whose root namespace is "http://schemas.microsoft.com/office/2006/metadata/contentType". This custom XML data part contains a schema element (in the "http://www.w3.org/2001/XMLSchema" namespace) that specifies an XML Schema for the element specified by the xpath attribute of the dataBinding element of the entityPicker. The rest of this section refers to this schema as the element schema.

The element schema specifies four attributes, each with a fixed value:

SystemInstance: Specifies the LobSystemInstance name. EntityNamespace: Specifies the Entity namespace. EntityName: Specifies the Entity name. BdcField: Specifies the name of the Field within the EntityInstance.

Together with the location of the document, these values specify the external content type that the user is selecting one or more instances of.

The result of the user choosing an instance of an external content type is an EntityInstanceId, and values of one or more Fields within the EntityInstance.

The element schema further specifies three more attributes, each with a fixed value, which collectively specify where to place the EntityInstanceId, and the Field values resulting from the user’s selection:

RelatedFieldWssStaticName: Specifies a sibling of the XML element specified by the xpath attribute of the dataBinding element mentioned earlier. The text of this element MUST be set to the EntityInstance Identifier obtained from user choosing an instance of the external content type. SecondaryFieldBdcNames: Specifies a list of names of Fields within the EntityInstance (the fields whose values resulted from user’s choice). The list MUST contain the same number of names as the SecondaryFieldsWssStaticNames attribute. SecondaryFieldsWssStaticNames: Specifies a corresponding list of names of XML elements that are siblings of the XML element specified by the xpath attribute of the dataBinding element mentioned earlier. The list MUST contain the same number of names as the SecondaryFieldBdcNames attribute.

The value (resulting from the user’s choice) of each one of the Fields within the EntityInstance specified by SecondaryFieldBdcNames MUST be set as the text of the XML element whose name appears at the same index in SecondaryFieldsWssStaticNames.

The list of names specified by SecondaryFieldBdcNames and SecondaryFieldsWssStaticNames MUST be encoded as follows:

  1. Start with an empty string.

  2. For each name, append the length of the name, plus one, as a base-10 integer, each value followed by a single space character.

  3. The names are then appended to the string, in the same order in which their lengths were added in step 2, followed by a single space character.

     43 / 118
    

    [MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

  4. The zero-based character position of where the first name begins in the string is then appended to the string.

  5. Finally, the resulting string is escaped as specified by [RFC3986].

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="entityPicker" type="w:CT_Empty"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.16 glow

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_Glow element that specifies the glow effect, a colored, blurred outline that is added outside the edges of text. By default, text does not have glow. See section 2.2.1 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="glow" minOccurs="0" type="CT_Glow"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.17 ligatures

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_Ligatures element that specifies which kinds of ligatures to use when displaying the text. (For more information about ligatures, see [ISO/IEC-14496-22].) By default, no ligatures are used. See section 2.2.1 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="ligatures" minOccurs="0" type="CT_Ligatures"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.18 numForm

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_NumForm element that specifies the form in which numerals are displayed. (For more information about number forms, see [ISO/IEC-14496-22].) By default, numerals are displayed in the font’s default form. See section 2.2.1 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="numForm" minOccurs="0" type="CT_NumForm"/>

    44 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.19 numSpacing

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_NumSpacing element that specifies which spacing form of the numeral is displayed. (For more information about numeral spacing, see [ISO/IEC-14496-22].) By default, the font’s default form is used. See section 2.2.1 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="numSpacing" minOccurs="0" type="CT_NumSpacing"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.20 props3d

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_Props3D element that specifies the 3-D properties of text, including bevel, extrusion, contour, and material. By default, text does not have 3-D properties. See section 2.2.1 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="props3d" minOccurs="0" type="CT_Props3D"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.21 reflection

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_Reflection element that specifies the reflection effect. By default, text does not have reflection. See section 2.2.1 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="reflection" minOccurs="0" type="CT_Reflection"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.22 scene3d

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_Scene3D element that specifies 3-D scene properties of text, including camera and lighting. By default, text does not have 3-D scene properties. See section 2.2.1 for how this element integrates with ISO/IEC-29500-1.

    45 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="scene3d" minOccurs="0" type="CT_Scene3D"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.23 shadow

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_Shadow element that specifies the shadow effect. By default, text does not have shadow. See section 2.2.1 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="shadow" minOccurs="0" type="CT_Shadow"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.24 stylisticSets

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_StylisticSets element that specifies a list of stylistic sets that modify the display of OpenType fonts. (For more information about stylistic sets, see [ISO/IEC-14496-22].) By default, there are no stylistic sets enabled. See section 2.2.1 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="stylisticSets" minOccurs="0" type="CT_StylisticSets"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.1.25 textFill

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_FillTextEffect element that specifies the fill for text. By default, this element is absent. When this element is absent, the color of text is determined by the color element (as specified in [ISO/IEC29500-1:2016] section 17.3.2.6). See section 2.2.1 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="textFill" minOccurs="0" type="CT_FillTextEffect"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

    46 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

2.6.1.26 textOutline

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

A CT_TextOutlineEffect element that specifies the outline style to be applied to text. By default, text does not have outline. See section 2.2.1 for how this element integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="textOutline" minOccurs="0" type="CT_TextOutlineEffect"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.2 Attributes

2.6.2.1 anchorId

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

An ST_LongHexNumber (as specified by [ISO/IEC29500-1:2016] section 17.18.50) attribute that specifies an identifier for the element this attribute is applied to. Values MUST be greater than 0 and less than 0x80000000. See section 2.2.6 for how this attribute integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this attribute.

<xsd:attribute name="anchorId" type="w:ST_LongHexNumber"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.2.2 noSpellErr

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

An ST_OnOff (as specified in [ISO/IEC29500-1:2016] section 22.9.2.7) attribute that when applied to a paragraph specifies whether the text of that paragraph is free of detected spelling errors. A value of 1 specifies that no spelling errors were detected in this paragraph. A value of 0 specifies that no information is available about spelling errors in the text of the paragraph. The default value for this attribute is 0. See section 2.2.4 for how this attribute integrates with [ISO/IEC29500-1:2016].

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this attribute.

<xsd:attribute name="noSpellErr" type="w:ST_OnOff"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.2.3 paraId

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

An ST_LongHexNumber (as specified by [ISO/IEC29500-1:2016] section 17.18.50) attribute that specifies an identifier for a paragraph that is unique within the document part (as specified by

    47 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

[ISO/IEC29500-1:2016] section 11.3), with the exception that it need not be unique across the choices or fallback of an Alternate Content block (as specified by [ISO/IEC29500-1:2016] section 17.17.3). Values MUST be greater than 0 and less than 0x80000000. See section 2.2.4 for how this attribute integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this attribute.

<xsd:attribute name="paraId" type="w:ST_LongHexNumber"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.2.4 textId

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

An ST_LongHexNumber (as specified by [ISO/IEC29500-1:2016] section 17.18.50) attribute that specifies a version identifier for a paragraph. Values MUST be greater than 0 and less than 0x80000000. Any element having this attribute MUST also have the paraId attribute.

If two documents have the same docId, then if two paragraphs within the same respective document part (as specified by [ISO/IEC29500-1:2016] section 11.3) that have the same paraId and textId SHOULD contain identical text, although formatting could differ. See section 2.2.4 for how this attribute integrates with ISO/IEC-29500-1.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this attribute.

<xsd:attribute name="textId" type="w:ST_LongHexNumber"/>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3 Complex Types

2.6.3.1 CT_Bevel

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_Props3D

A complex type that specifies the bevel properties.

Attributes:

w: An optional ST_PositiveCoordinate (as specified in [ISO/IEC29500-1:2016] section 20.1.10.42) attribute that specifies the width of the bevel. This attribute MAY<49> be limited further in the application. The default value for this attribute is 0.

h: An optional ST_PositiveCoordinate (as specified in [ISO/IEC29500-1:2016] section 20.1.10.42) attribute that specifies the height of the bevel. This attribute MAY<50> be limited further in the application. The default value for this attribute is 0.

prst: An optional ST_BevelPresetType attribute that specifies the preset bevel type that defines the appearance of the bevel. The default value for this attribute is the circle preset type.

48 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Bevel"> <xsd:attribute name="w" type="a:ST_PositiveCoordinate" use="optional"/> <xsd:attribute name="h" type="a:ST_PositiveCoordinate" use="optional"/> <xsd:attribute name="prst" type="ST_BevelPresetType" use="optional"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.2 CT_Camera

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_Scene3D

A complex type that specifies the placement of the camera in the 3D scene.

Attributes:

prst: An ST_PresetCameraType attribute that specifies the presets that define the position of the camera in space. Applications MAY restrict the values of this attribute<51>.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Camera"> <xsd:attribute name="prst" use="required" type="ST_PresetCameraType"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.3 CT_Color

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_Props3D

A complex type that specifies the color.

Child Elements:

srgbClr: A CT_SRgbColor element that specifies the color in the RGB color model.

schemeClr: A CT_SchemeColor element that specifies a color from a theme. Color changes if theme bindings change.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Color"> xsd:sequence <xsd:group ref="EG_ColorChoice"/> </xsd:sequence> </xsd:complexType>

  49 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.4 CT_DefaultImageDpi

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: defaultImageDpi

A complex type that specifies that default dots per inch (DPI) to be used to save each image in the document.

Attributes:

val: An ST_DecimalNumber (as specified in [ISO/IEC29500-1:2016] section 17.18.10) attribute that specifies the DPI at which the images in the document will be saved.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_DefaultImageDpi"> <xsd:attribute name="val" type="w:ST_DecimalNumber" use="required"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.5 CT_FillTextEffect

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: textFill

A complex type that specifies a fill. If this element has no child elements, a default of solid black fill is applied.

Child Elements:

noFill: A CT_Empty (as specified in [ISO/IEC29500-1:2016] section A.1) element that specifies that no fill is applied to text.

solidFill: A CT_SolidColorFillProperties element that specifies a solid color fill. The text is filled entirely with the specified color.

gradFill: A CT_GradientFillProperties element that specifies the gradient fill. A gradient fill is a fill that is characterized by a smooth gradual transition from one color to the next.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_FillTextEffect"> xsd:sequence <xsd:group ref="EG_FillProperties" minOccurs="0"/> </xsd:sequence> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

  50 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

2.6.3.6 CT_Glow

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: glow

A complex type that specifies the color and radius of glow.

Child Elements:

srgbClr: A CT_SRgbColor element that specifies the color in the RGB color model.

schemeClr: A CT_SchemeColor element that specifies a color from a theme. Color changes if theme bindings change.

Attributes:

rad: An optional ST_PositiveCoordinate (as specified in [ISO/IEC29500-1:2016] section 20.1.10.42) attribute that specifies the radius of glow. This attribute MAY<52> be limited further in the application. The default value for this attribute is 0.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Glow"> xsd:sequence <xsd:group ref="EG_ColorChoice"/> </xsd:sequence> <xsd:attribute name="rad" use="optional" type="a:ST_PositiveCoordinate"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.7 CT_GradientFillProperties

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_TextOutlineEffect, CT_FillTextEffect

A complex type that specifies a gradient fill. A gradient fill is a fill that is characterized by a smooth gradual transition from one color to the next.

The desired transition colors and locations are specified in the gradient stop list (gsLst) child element. When this element has neither lin nor path child elements, a default lin element with ang = 0 and scaled = false is assumed.

Child Elements:

gsLst: A CT_GradientStopList element that specifies gradient colors and their relative positions in the color band. Black solid fill is used as a default when this element is absent.

lin: A CT_LinearShadeProperties element that specifies a linear gradient.

path: A CT_PathShadeProperties element that specifies that the gradient fill follows a path versus a linear line.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_GradientFillProperties">

  51 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

  <xsd:sequence>
  <xsd:element name="gsLst" type="CT_GradientStopList" minOccurs="0"/>
      <xsd:group ref="EG_ShadeProperties" minOccurs="0"/>
  </xsd:sequence>
  </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.8 CT_GradientStop

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_GradientStopList

A complex type that specifies a gradient stop. A gradient stop consists of a position where the stop appears in the color band.

Child Elements:

srgbClr: A CT_SRgbColor element that specifies the color in the RGB color model.

schemeClr: A CT_SchemeColor element that specifies a color from a theme. Color changes if theme bindings change.

Attributes:

pos: A ST_PositiveFixedPercentage as specified in [ISO/IEC29500-4:2016] section 17.2.2.3 and [ISO/IEC29500-1:2016] section 20.1.10.45 that specifies where this gradient stop appears in the color band.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_GradientStop"> xsd:sequence <xsd:group ref="EG_ColorChoice"/> </xsd:sequence> <xsd:attribute name="pos" type="a:ST_PositiveFixedPercentage" use="required"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.9 CT_GradientStopList

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_GradientFillProperties

A complex type that contains a list of gradient stops. These gradient stops specify the gradient colors and their relative positions in the color band.

Child Elements:

gs: A CT_GradientStop element that specifies gradient stops.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

      52 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:complexType name="CT_GradientStopList"> xsd:sequence <xsd:element name="gs" type="CT_GradientStop" minOccurs="2" maxOccurs="10"/> </xsd:sequence> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.10 CT_Ligatures

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: ligatures

A complex type that specifies which kinds of ligatures to use when displaying the text.

Attributes:

val: An ST_Ligatures attribute that specifies which kinds of ligatures to use when displaying the text.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Ligatures"> <xsd:attribute name="val" type="ST_Ligatures" use="required"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.11 CT_LightRig

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_Scene3D

A complex type that specifies the lighting properties associated with the scene.

Child Elements:

rot: A CT_SphereCoords element that specifies the rotation in 3-D space. By default the light rig is not rotated.

Attributes:

rig: An ST_LightRigType attribute that specifies the preset type of light rig that is to be applied to the scene.

dir: An ST_LightRigDirection attribute that specifies the direction from which the light rig is oriented in relation to the scene.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_LightRig"> xsd:sequence <xsd:element name="rot" type="CT_SphereCoords" minOccurs="0"/> </xsd:sequence> <xsd:attribute name="rig" type="ST_LightRigType" use="required"/>

  53 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:attribute name="dir" type="ST_LightRigDirection" use="required"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.12 CT_LinearShadeProperties

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_GradientFillProperties

A complex type that specifies linear gradient.

Attributes:

ang: An optional ST_PositiveFixedAngle (as specified in [ISO/IEC29500-1:2016] section 20.1.10.44) attribute that specifies the direction of color change for the gradient. To define this angle, let its value be x measured clockwise. Then (-sin x, cos x) is a vector parallel to the line of constant color in the gradient fill. Default value for this attribute is 0.

scaled: An optional ST_OnOff attribute that specifies whether the gradient angle scales with the fill area. Mathematically, if this flag is true, then the gradient vector (cos x, sin x) is scaled by the width(w) and height(h) of the fill area, so that the vector becomes (w cos x, h sin x) (before normalization). Observe that now if the gradient angle is 45 degrees, the gradient vector is (w,h), which goes from top-left to bottom–right of the fill area. If this flag is false, the gradient angle is independent of the fill area and is not scaled using the manipulation described earlier. So a 45-degree gradient angle gives a gradient band whose line of constant color is parallel to the vector (1, -1). By default, linear shade is not scaled.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_LinearShadeProperties"> <xsd:attribute name="ang" type="a:ST_PositiveFixedAngle" use="optional"/> <xsd:attribute name="scaled" type="ST_OnOff" use="optional"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.13 CT_LineJoinMiterProperties

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_TextOutlineEffect

A complex type that specifies that a line join is mitered (as specified in [ISO/IEC29500-1:2016] §20.1.8.43).

Attributes:

lim: An optional ST_PositivePercentage as specified in [ISO/IEC29500-4:2016] section 17.2.2.4 and [ISO/IEC29500-1:2016] section 20.1.10.46 that specifies the amount by which lines are extended to form a miter join – otherwise miter joins can extend infinitely far (for lines which are almost parallel). The default value for this attribute is 0.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

  54 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:complexType name="CT_LineJoinMiterProperties"> <xsd:attribute name="lim" type="a:ST_PositivePercentage" use="optional"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.14 CT_LongHexNumber

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: docId

A complex type that represents a 32-bit integer. Value ranges from 0 to 0xFFFFFFFF.

Attributes:

val: An ST_LongHexNumber (as specified by [ISO/IEC29500-1:2016] section 17.18.50) attribute that specifies the value of the property.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_LongHexNumber"> <xsd:attribute name="val" type="w:ST_LongHexNumber" use="required"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.15 CT_NumForm

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: numForm

A complex type that specifies the form in which numerals are displayed.

Attributes:

val: A required ST_NumForm attribute that specifies the form in which numerals are displayed.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_NumForm"> <xsd:attribute name="val" type="ST_NumForm" use="required"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.16 CT_NumSpacing

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: numSpacing

A complex type that specifies the form in which numerals are displayed.

 55 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Attributes:

val: An ST_NumSpacing attribute that specifies the form in which numerals are displayed.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_NumSpacing"> <xsd:attribute name="val" type="ST_NumSpacing" use="required"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.17 CT_OnOff

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_SdtCheckbox, conflictMode, discardImageEditingData, cntxtAlts

A complex type that specifies a value for a Boolean (true or false) property.

Attributes:

val: An optional ST_OnOff attribute that specifies the value of the property. By default, the value is true.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_OnOff"> <xsd:attribute name="val" type="ST_OnOff"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.18 CT_PathShadeProperties

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_GradientFillProperties

A complex type that specifies that a gradient fill follows a path versus a linear line.

Child Elements:

fillToRect: A CT_RelativeRect element that specifies the focus rectangle for center shade (as specified in [ISO/IEC29500-1:2016] section 20.1.8.31). Center shade fills the entire shape except the margins specified by each attribute of this element. Each edge of the center shade rectangle is specified by a percentage offset from the corresponding edge of the container. A positive percentage specifies an inset and a negative percentage specifies an outset. By default, center shade fills the entire shape.

Attributes:

path: An optional ST_PathShadeType attribute that specifies the shape of the path to follow. By default, gradient fill will follow a rectangular path.

 56 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_PathShadeProperties"> xsd:sequence <xsd:element name="fillToRect" type="CT_RelativeRect" minOccurs="0"/> </xsd:sequence> <xsd:attribute name="path" type="ST_PathShadeType" use="optional"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.19 CT_Percentage

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_SRgbColor, CT_SchemeColor

A complex type that specifies a percentage in thousandths of a percent. For example, the value of 1 represents 0.001%.

Attributes:

val: An ST_Percentage as specified in [ISO/IEC29500-4:2016] section 17.2.2.2 and [ISO/IEC29500-1:2016] section 20.1.10.40 that specifies the value.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Percentage"> <xsd:attribute name="val" type="a:ST_Percentage" use="required"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.20 CT_PositiveFixedPercentage

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_SRgbColor, CT_SchemeColor

A complex type that specifies a percentage in thousandths of a percent. Its value ranges from 0% to 100%.

Attributes:

val: An ST_PositiveFixedPercentage as specified in [ISO/IEC29500-4:2016] section 17.2.2.3 and [ISO/IEC29500-1:2016] section 20.1.10.45 that specifies the value.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_PositiveFixedPercentage"> <xsd:attribute name="val" type="a:ST_PositiveFixedPercentage" use="required"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

     57 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

2.6.3.21 CT_PositivePercentage

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_SRgbColor, CT_SchemeColor

A complex type that specifies a positive percentage in thousandths of a percent.

Attributes:

val: An ST_PositivePercentage as specified in [ISO/IEC29500-4:2016] section 17.2.2.4 and [ISO/IEC29500-1:2016] section 20.1.10.46 that specifies the value.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_PositivePercentage"> <xsd:attribute name="val" type="a:ST_PositivePercentage" use="required"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.22 CT_PresetLineDashProperties

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_TextOutlineEffect

A complex type that specifies the type of line dashing scheme to use.

Attributes:

val: An optional ST_PresetLineDashVal attribute that specifies the type of preset dashing scheme to be used. By default, a solid line is used.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_PresetLineDashProperties"> <xsd:attribute name="val" type="ST_PresetLineDashVal" use="optional"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.23 CT_Props3D

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: props3d

A complex type that specifies 3-D properties associated with text.

Child Elements:

bevelT: A CT_Bevel element that specifies the top bevel of text.

bevelB: A CT_Bevel element that specifies the bottom bevel of text.

 58 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

extrusionClr: A CT_Color element that specifies the extrusion color. In absence of this element, black is used as default.

contourClr: A CT_Color element that specifies the contour color. In absence of this element, black is used as default.

Attributes:

extrusionH: An ST_PositiveCoordinate (as specified in [ISO/IEC29500-1:2016] section 20.1.10.42) attribute that specifies height of extrusion. This attribute MAY<53> be limited further in the application. The default value for this attribute is 0.

contourW: An ST_PositiveCoordinate (as specified in [ISO/IEC29500-1:2016] section 20.1.10.42) attribute that specifies width of contour. This attribute MAY<54> be limited further in the application. The default value for this attribute is 0.

prstMaterial: An ST_PresetMaterialType attribute that specifies preset material type. The default value for this attribute is warm matte.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Props3D"> xsd:sequence <xsd:element name="bevelT" type="CT_Bevel" minOccurs="0"/> <xsd:element name="bevelB" type="CT_Bevel" minOccurs="0"/> <xsd:element name="extrusionClr" type="CT_Color" minOccurs="0"/> <xsd:element name="contourClr" type="CT_Color" minOccurs="0"/> </xsd:sequence> <xsd:attribute name="extrusionH" type="a:ST_PositiveCoordinate" use="optional"/> <xsd:attribute name="contourW" type="a:ST_PositiveCoordinate" use="optional"/> <xsd:attribute name="prstMaterial" type="ST_PresetMaterialType" use="optional"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.24 CT_Reflection

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: reflection

A complex type that specifies the reflection effect.

Attributes:

blurRad: An optional ST_PositiveCoordinate (as specified in [ISO/IEC29500-1:2016] section 20.1.10.42) attribute that specifies the blur radius. This attribute MAY be limited further in the application<55>. The default value for this attribute is 0.

stA: An optional ST_PositiveFixedPercentage (as specified in [ISO/IEC29500-4:2016] section 17.2.2.3 and [ISO/IEC29500-1:2016] section 20.1.10.45) that specifies the starting reflection opacity. stA stands for Start Alpha. The default value for this attribute is 0.

stPos: An optional ST_PositiveFixedPercentage (as specified in [ISO/IEC29500-4:2016] section 17.2.2.3 and [ISO/IEC29500-1:2016] section 20.1.10.45) that specifies the start position along the gradient ramp of the start alpha value. The default value for this attribute is 0.

       59 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

endA: An optional ST_PositiveFixedPercentage (as specified in [ISO/IEC29500-4:2016] section 17.2.2.3 and [ISO/IEC29500-1:2016] section 20.1.10.45) that specifies the ending reflection opacity. endA stands for End Alpha. The default value for this attribute is 0.

endPos: An optional ST_PositiveFixedPercentage (as specified in [ISO/IEC29500-4:2016] section 17.2.2.3 and [ISO/IEC29500-1:2016] section 20.1.10.45) that specifies the end position along the gradient ramp of the end alpha value. The default value for this attribute is 0.

dist: An optional ST_PositiveCoordinate (as specified in [ISO/IEC29500-1:2016] section 20.1.10.42) attribute that specifies how far to offset the reflection from the text. This attribute MAY be limited further in the application<56>. The default value for this attribute is 0.

dir: An optional ST_PositiveFixedAngle (as specified in [ISO/IEC29500-1:2016] section 20.1.10.44) attribute that specifies the direction to offset the reflection. The default value for this attribute is 0.

fadeDir: An optional ST_PositiveFixedAngle (as specified in [ISO/IEC29500-1:2016] section 20.1.10.44) attribute that specifies the direction of the alpha gradient ramp relative to the text. The default value for this attribute is 0.

sx: An optional ST_Percentage (as specified in [ISO/IEC29500-4:2016] section 17.2.2.2 and [ISO/IEC29500-1:2016] section 20.1.10.40) that specifies the horizontal scale factor. The default value for this attribute is 0.

sy: An optional ST_Percentage (as specified in [ISO/IEC29500-4:2016] section 17.2.2.2 and [ISO/IEC29500-1:2016] section 20.1.10.40) that specifies the vertical scale factor. The default value for this attribute is 0.

kx: An optional ST_FixedAngle (as specified in [ISO/IEC29500-1:2016] section 20.1.10.23) attribute that specifies the horizontal skew angle. The default value for this attribute is 0.

ky: An optional ST_FixedAngle (as specified in [ISO/IEC29500-1:2016] section 20.1.10.23) attribute that specifies the vertical skew angle. The default value for this attribute is 0.

algn: An optional ST_RectAlignment attribute that specifies the reflection alignment. The default value for this attribute is "none".

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Reflection">
  <xsd:attribute name="blurRad" use="optional" type="a:ST_PositiveCoordinate"/>
  <xsd:attribute name="stA" use="optional" type="a:ST_PositiveFixedPercentage"/>
  <xsd:attribute name="stPos" use="optional" type="a:ST_PositiveFixedPercentage"/>
  <xsd:attribute name="endA" use="optional" type="a:ST_PositiveFixedPercentage"/>
  <xsd:attribute name="endPos" use="optional" type="a:ST_PositiveFixedPercentage"/>
  <xsd:attribute name="dist" use="optional" type="a:ST_PositiveCoordinate"/>
  <xsd:attribute name="dir" use="optional" type="a:ST_PositiveFixedAngle"/>
  <xsd:attribute name="fadeDir" use="optional" type="a:ST_PositiveFixedAngle"/>
  <xsd:attribute name="sx" use="optional" type="a:ST_Percentage"/>
  <xsd:attribute name="sy" use="optional" type="a:ST_Percentage"/>
  <xsd:attribute name="kx" use="optional" type="a:ST_FixedAngle"/>
  <xsd:attribute name="ky" use="optional" type="a:ST_FixedAngle"/>
  <xsd:attribute name="algn" use="optional" type="ST_RectAlignment"/>
</xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.25 CT_RelativeRect

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

    60 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Referenced by: CT_PathShadeProperties

A complex type that specifies a rectangle relative to its parent. Each edge of this rectangle is defined by a percentage offset from the corresponding edge of the parent.

Attributes:

l: An optional ST_Percentage as specified in [ISO/IEC29500-4:2016] section 17.2.2.2 and [ISO/IEC29500-1:2016] section 20.1.10.40 that specifies the left edge of the rectangle. Default value for this attribute is 0.

t: An optional ST_Percentage as specified in [ISO/IEC29500-4:2016] section 17.2.2.2 and [ISO/IEC29500-1:2016] section 20.1.10.40 that specifies the top edge of the rectangle. Default value for this attribute is 0.

r: An optional ST_Percentage as specified in [ISO/IEC29500-4:2016] section 17.2.2.2 and [ISO/IEC29500-1:2016] section 20.1.10.40 that specifies the right edge of the rectangle. Default value for this attribute is 0.

b: An optional ST_Percentage as specified in [ISO/IEC29500-4:2016] section 17.2.2.2 and [ISO/IEC29500-1:2016] section 20.1.10.40 that specifies the bottom edge of the rectangle. Default value for this attribute is 0.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_RelativeRect"> <xsd:attribute name="l" use="optional" type="a:ST_Percentage"/> <xsd:attribute name="t" use="optional" type="a:ST_Percentage"/> <xsd:attribute name="r" use="optional" type="a:ST_Percentage"/> <xsd:attribute name="b" use="optional" type="a:ST_Percentage"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.26 CT_Scene3D

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: scene3d

A complex type that specifies 3-D scene properties.

Child Elements:

camera: A CT_Camera element that specifies the placement of the camera.

lightRig: A CT_LightRig element that specifies the lighting properties associated with the scene.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Scene3D"> xsd:sequence <xsd:element name="camera" type="CT_Camera"/> <xsd:element name="lightRig" type="CT_LightRig"/> </xsd:sequence> </xsd:complexType>

   61 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.27 CT_SchemeColor

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_Glow, CT_Shadow, CT_SolidColorFillProperties, CT_GradientStop, CT_Color

A complex type that specifies a color bound to the document’s theme (as specified in [ISO/IEC29500- 1:2016] section 20.1.6.9), and an optional list of color transforms to apply to the base color.

Child Elements:

tint: A CT_PositiveFixedPercentage element that specifies a lighter version of its input color. 10% tint is 10% of input color combined with 90% white. By default, color does not have tint.

shade: A CT_PositiveFixedPercentage element that specifies darker version of its input color. 10% shade is 10% of input color combined with 90% black. By default, color does not have shade.

alpha: A CT_PositiveFixedPercentage element that specifies its input color with the specific opacity, but with its color unchanged. By default color does not have alpha.

hueMod: A CT_PositivePercentage element that specifies the input color with its hue modulated by the given percentage. A 50% hue modulate decreases the angular hue value by half. A 200% hue modulate doubles the angular hue value. By default, color does not have modulated hue.

sat: A CT_Percentage element that specifies input color with the specified saturation, but with its hue and luminance unchanged. By default, color does not have saturation.

satOff: A CT_Percentage element that specifies the input color with its saturation shifted, but with its hue and luminance unchanged. A 10% offset to 20% saturation yields 30% saturation. By default, color does not have saturation offset.

satMod: A CT_Percentage element that specifies the input color with its saturation modulated by the given percentage. A 50% saturation modulate reduces the saturation by half. A 200% saturation modulate doubles the saturation. By default, color does not have modulated saturation.

lum: A CT_Percentage element that specifies the input color with the specific luminance, but its hue and saturation unchanged. By default, color does not have luminance.

lumOff: A CT_Percentage element that specifies the input color with its luminance shifted, but with its hue and saturation unchanged. A 10% offset to 20% luminance yields 30% luminance. By default, color does not have luminance offset.

lumMod: A CT_Percentage element that specifies the input color with its luminance modulated by the given percentage. A 50% luminance modulate reduces the luminance by half. A 200% luminance modulate doubles the luminance. By default, color does not have modulated luminance.

Attributes:

val: An ST_SchemeColorVal attribute that specifies the desired scheme color.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_SchemeColor">
  <xsd:sequence>
    <xsd:group ref="EG_ColorTransform" minOccurs="0" maxOccurs="unbounded"/>
  </xsd:sequence>
  <xsd:attribute name="val" type="ST_SchemeColorVal" use="required"/>


    62 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

</xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.28 CT_SdtCheckbox

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: checkbox

A complex type that specifies the properties of a structured document tag (as specified in [ISO/IEC29500-1:2016] section 17.5.2) in the form of a checkbox.

Child Elements:

checked: An optional CT_OnOff element that specifies whether the checkbox is checked. By default, a checkbox is unchecked.

checkedState: An optional CT_SdtCheckboxSymbol element that specifies the symbol used to represent the checked state of the checkbox. By default, the symbol used to represent a checked checkbox is the 0x2612 Unicode character in the "MS Gothic" font.

uncheckedState: An optional CT_SdtCheckboxSymbol element that specifies the symbol used to represent the unchecked state of the checkbox. By default, the symbol used to represent an unchecked checkbox is the 0x2610 Unicode character in the "MS Gothic" font.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_SdtCheckbox"> xsd:sequence <xsd:element name="checked" type="CT_OnOff" minOccurs="0"/> <xsd:element name="checkedState" type="CT_SdtCheckboxSymbol" minOccurs="0"/> <xsd:element name="uncheckedState" type="CT_SdtCheckboxSymbol" minOccurs="0"/> </xsd:sequence> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.29 CT_SdtCheckboxSymbol

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_SdtCheckbox

This complex type specifies a symbol to be used for a checkbox state.

Attributes:

font: An optional ST_String attribute (as specified in [ISO/IEC29500-1:2016] section 22.9.2.13) that specifies the font that will be used to format this symbol. By default, the font is "MS Gothic"

val: An optional ST_ShortHexNumber (as specified in [ISO/IEC29500-1:2016] section 17.18.79) attribute that specifies the hexadecimal code for the Unicode character value of the symbol. By default, the value is "0x2612" for checked states and "0x2610" for unchecked states.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

   63 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:complexType name="CT_SdtCheckboxSymbol">
 <xsd:attribute name="font" type="w:ST_String"/>
 <xsd:attribute name="val" type="w:ST_ShortHexNumber"/>
</xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.30 CT_Shadow

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: shadow

A complex type that specifies the shadow effect.

Child Elements:

srgbClr: A CT_SRgbColor element that specifies the color in the RGB color model.

schemeClr: A CT_SchemeColor element that specifies a color from a theme. Color changes if theme bindings change.

Attributes:

blurRad: An optional ST_PositiveCoordinate (as specified in [ISO/IEC29500-1:2016] section 20.1.10.42) attribute that specifies the blur radius of the shadow. This attribute MAY<57> be limited further in the application. The default value for this attribute is 0.

dist: An optional ST_PositiveCoordinate (as specified in [ISO/IEC29500-1:2016] section 20.1.10.42) attribute that specifies how far to offset the shadow. This attribute MAY<58> be limited further in the application. The default value for this attribute is 0.

dir: An optional ST_PositiveFixedAngle (as specified in [ISO/IEC29500-1:2016] section 20.1.10.44) attribute that specifies the direction to offset the shadow. The default value for this attribute is 0.

sx: An optional ST_Percentage (as specified in [ISO/IEC29500-4:2016] section 17.2.2.2 and [ISO/IEC29500-1:2016] section 20.1.10.40) that specifies the horizontal scaling factor. Negative scaling causes a flip. The default value for this attribute is 0.

sy: An optional ST_Percentage (as specified in [ISO/IEC29500-4:2016] section 17.2.2.2 and [ISO/IEC29500-1:2016] section 20.1.10.40) that specifies the vertical scaling factor. Negative scaling causes a flip. The default value for this attribute is 0.

kx: An optional ST_FixedAngle (as specified in [ISO/IEC29500-1:2016] section 20.1.10.23) attribute that specifies the horizontal skew angle. The default value for this attribute is 0.

ky: An optional ST_FixedAngle (as specified in [ISO/IEC29500-1:2016] section 20.1.10.23) attribute that specifies the vertical skew angle. The default value for this attribute is 0.

algn: An optional ST_RectAlignment attribute that specifies the alignment of the shadow. The default value for this attribute is "none".

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Shadow">
 <xsd:sequence>
 <xsd:group ref="EG_ColorChoice"/>
 </xsd:sequence>
 <xsd:attribute name="blurRad" use="optional" type="a:ST_PositiveCoordinate"/>

     64 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:attribute name="dist" use="optional" type="a:ST_PositiveCoordinate"/> <xsd:attribute name="dir" use="optional" type="a:ST_PositiveFixedAngle"/> <xsd:attribute name="sx" use="optional" type="a:ST_Percentage"/> <xsd:attribute name="sy" use="optional" type="a:ST_Percentage"/> <xsd:attribute name="kx" use="optional" type="a:ST_FixedAngle"/> <xsd:attribute name="ky" use="optional" type="a:ST_FixedAngle"/> <xsd:attribute name="algn" use="optional" type="ST_RectAlignment"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.31 CT_SolidColorFillProperties

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_TextOutlineEffect, CT_FillTextEffect

A complex type that specifies a solid color fill. If this element has no child elements, black is used as a default.

Child Elements:

srgbClr: A CT_SRgbColor element that specifies the color in the RGB color model.

schemeClr: A CT_SchemeColor element that specifies a color from a theme. Color changes if theme bindings change.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_SolidColorFillProperties"> xsd:sequence <xsd:group ref="EG_ColorChoice" minOccurs="0"/> </xsd:sequence> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.32 CT_SphereCoords

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_LightRig

A complex type that specifies sphere coordinates using a latitude coordinate, a longitude coordinate, and a revolution around the central axis.

Attributes:

lat: An ST_PositiveFixedAngle (as specified in [ISO/IEC29500-1:2016] section 20.1.10.44) attribute that specifies the latitude.

lon: An ST_PositiveFixedAngle (as specified in [ISO/IEC29500-1:2016] section 20.1.10.44) attribute that specifies the longitude.

rev: An ST_PositiveFixedAngle (as specified in [ISO/IEC29500-1:2016] section 20.1.10.44) attribute that specifies the revolution around the central axis.

  65 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_SphereCoords">
  <xsd:attribute name="lat" type="a:ST_PositiveFixedAngle" use="required"/>
  <xsd:attribute name="lon" type="a:ST_PositiveFixedAngle" use="required"/>
  <xsd:attribute name="rev" type="a:ST_PositiveFixedAngle" use="required"/>
</xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.33 CT_SRgbColor

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_Glow, CT_Shadow, CT_SolidColorFillProperties, CT_GradientStop, CT_Color

A complex type that specifies a color using the RGB color model. Red, green, and blue are expressed as a sequence of hex digits, RRGGBB. This type optionally specifies a list of color transforms applied to the base color.

Child Elements:

tint: A CT_PositiveFixedPercentage element that specifies a lighter version of its input color. 10% tint is 10% of input color combined with 90% white. By default, color does not have tint.

shade: A CT_PositiveFixedPercentage element that specifies darker version of its input color. 10% shade is 10% of input color combined with 90% black. By default, color does not have shade.

alpha: A CT_PositiveFixedPercentage element that specifies its input color with the specific opacity, but with its color unchanged. By default color does not have alpha.

hueMod: A CT_PositivePercentage element that specifies the input color with its hue modulated by the given percentage. A 50% hue modulate decreases the angular hue value by half. A 200% hue modulate doubles the angular hue value. By default, color does not have modulated hue.

sat: A CT_Percentage element that specifies input color with the specified saturation, but with its hue and luminance unchanged. By default, color does not have saturation.

satOff: A CT_Percentage element that specifies the input color with its saturation shifted, but with its hue and luminance unchanged. A 10% offset to 20% saturation yields 30% saturation. By default, color does not have saturation offset.

satMod: A CT_Percentage element that specifies the input color with its saturation modulated by the given percentage. A 50% saturation modulate reduces the saturation by half. A 200% saturation modulate doubles the saturation. By default, color does not have modulated saturation.

lum: A CT_Percentage element that specifies the input color with the specific luminance, but its hue and saturation unchanged. By default, color does not have luminance.

lumOff: A CT_Percentage element that specifies the input color with its luminance shifted, but with its hue and saturation unchanged. A 10% offset to 20% luminance yields 30% luminance. By default, color does not have luminance offset.

lumMod: A CT_Percentage element that specifies the input color with its luminance modulated by the given percentage. A 50% luminance modulate reduces the luminance by half. A 200% luminance modulate doubles the luminance. By default, color does not have modulated luminance.

Attributes:

    66 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

val: An ST_HexColorRGB (as specified in [ISO/IEC29500-1:2016] section 22.9.2.5) attribute that specifies color in the RGB color model. Red, green, and blue are expressed in hex digits, RRGGBB.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_SRgbColor"> xsd:sequence <xsd:group ref="EG_ColorTransform" minOccurs="0" maxOccurs="unbounded"/> </xsd:sequence> <xsd:attribute name="val" type="w:ST_HexColorRGB" use="required"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.34 CT_StyleSet

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_StylisticSets

A complex type that specifies a reference to a set of character forms defined within the font to be used as a stylistic set. For more information about stylistic sets, see [ISO/IEC-14496-22].

Attributes:

id: An ST_UnsignedDecimalNumber attribute (see [ISO/IEC29500-1:2016] section 22.9.2.16) that specifies the stylistic set that this element represents. MUST be greater than or equal to 1 and less than or equal to 20.

val: An optional ST_OnOff attribute that specifies if the stylistic set specified by id is enabled. If set to "false", this element MUST be ignored. By default, the stylistic set specified by id is enabled.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_StyleSet"> <xsd:attribute name="id" type="w:ST_UnsignedDecimalNumber" use="required"/> <xsd:attribute name="val" type="ST_OnOff" use="optional"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.35 CT_StylisticSets

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: stylisticSets

A complex type that specifies a list of sets of character forms defined within the font, with each serving as a stylistic set. For more information about stylistic sets, see [ISO/IEC-14496-22]. This element can have any number of styleSet child elements.

Child Elements:

styleSet: A CT_StyleSet element that specifies a stylistic set.

  67 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_StylisticSets"> <xsd:sequence minOccurs="0"> <xsd:element name="styleSet" minOccurs="0" maxOccurs="unbounded" type="CT_StyleSet"/> </xsd:sequence> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.3.36 CT_TextOutlineEffect

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: textOutline

A complex type that specifies the outline style that can be applied to text. When this element is empty, bevel is used as default.

Child Elements:

noFill: A CT_Empty (as specified in [ISO/IEC29500-1:2016] section A.1) element that specifies that no fill is applied to text.

solidFill: A CT_SolidColorFillProperties element that specifies a solid color fill. The text is filled entirely with the specified color.

gradFill: A CT_GradientFillProperties element that specifies the gradient fill. A gradient fill is a fill that is characterized by a smooth gradual transition from one color to the next.

prstDash: A CT_PresetLineDashProperties element that specifies the type of line dashing scheme to use. By default, a solid line is used.

round: A CT_Empty (as specified in [ISO/IEC29500-1:2016] section A.1) element that specifies that lines are connected by round joints.

bevel: A CT_Empty (as specified in [ISO/IEC29500-1:2016] section A.1) element that specifies that lines are connected by angle joints.

miter: A CT_LineJoinMiterProperties element that specifies that the line joins are mitered.

Attributes:

w: An optional ST_LineWidth (as specified in [ISO/IEC29500-1:2016] section 20.1.10.35) attribute that specifies the width of the outline. By default, the outline has no width.

cap: An optional ST_LineCap attribute that specifies the ending caps for the lines. By default, lines end at endpoint.

cmpd: An optional ST_CompoundLine attribute that specifies the compound line type to be used. Normal width single line is used by default.

algn: An optional ST_PenAlignment attribute that specifies the alignment. Center pen alignment is used by default.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

  68 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:complexType name="CT_TextOutlineEffect"> xsd:sequence <xsd:group ref="EG_FillProperties" minOccurs="0"/> <xsd:group ref="EG_LineDashProperties" minOccurs="0"/> <xsd:group ref="EG_LineJoinProperties" minOccurs="0"/> </xsd:sequence> <xsd:attribute name="w" use="optional" type="a:ST_LineWidth"/> <xsd:attribute name="cap" use="optional" type="ST_LineCap"/> <xsd:attribute name="cmpd" use="optional" type="ST_CompoundLine"/> <xsd:attribute name="algn" use="optional" type="ST_PenAlignment"/> </xsd:complexType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4 Simple Types

2.6.4.1 ST_BevelPresetType

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_Bevel

A simple type that specifies the preset for a type of bevel. The bevel properties are applied differently depending on the type of bevel defined.

Possible values for this type are listed in the following table. See [ISO/IEC29500-1:2016] section 20.1.10.9 for details regarding the meaning of the listed values.

Value Meaning

relaxedInset Relaxed Inset type of bevel.

circle Circle type of bevel.

slope Slope type of bevel.

cross Cross type of bevel.

angle Angle type of bevel.

softRound Soft Round type of bevel.

convex Convex type of bevel.

coolSlant Cool Slant type of bevel.

divot Divot type of bevel.

riblet Riblet type of bevel.

hardEdge Hard Edge type of bevel.

artDeco Art Deco type of bevel.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_BevelPresetType">

                69 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:restriction base="xsd:token"> <xsd:enumeration value="relaxedInset"/> <xsd:enumeration value="circle"/> <xsd:enumeration value="slope"/> <xsd:enumeration value="cross"/> <xsd:enumeration value="angle"/> <xsd:enumeration value="softRound"/> <xsd:enumeration value="convex"/> <xsd:enumeration value="coolSlant"/> <xsd:enumeration value="divot"/> <xsd:enumeration value="riblet"/> <xsd:enumeration value="hardEdge"/> <xsd:enumeration value="artDeco"/> </xsd:restriction> </xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.2 ST_CompoundLine

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_TextOutlineEffect

A simple type that specifies the compound line type.

Possible values for this type are listed in the following table.

Value Meaning

sng Single line: one normal width.

dbl Double lines of equal width.

thickThin Double lines: one thick, one thin.

thinThick Double lines: one thin, one thick.

tri Three lines: thin, thick, thin.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_CompoundLine"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="sng"/> <xsd:enumeration value="dbl"/> <xsd:enumeration value="thickThin"/> <xsd:enumeration value="thinThick"/> <xsd:enumeration value="tri"/> </xsd:restriction> </xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.3 ST_Ligatures

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

             70 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Referenced by: CT_Ligatures

A simple type that specifies which types of ligatures are enabled for this run of text. For more information about ligatures, see [ISO/IEC-14496-22].

Possible values for this type are listed in the following table.

Value Meaning

none Specifies that the text is not displayed using ligatures.

standard Specifies that the text is displayed using standard ligatures if they are supported by the font.

contextual Specifies that the text is displayed using contextual ligatures if they are supported by the font.

historical Specifies that the text is displayed using historical ligatures if they are supported by the font.

discretional Specifies that the text is displayed using discretional ligatures if they are supported by the font.

standardContextual Specifies that the text is displayed using standard and contextual ligatures if they are supported by the font.

standardHistorical Specifies that the text is displayed using standard and historical ligatures if they are supported by the font.

contextualHistorical Specifies that the text is displayed using contextual and historical ligatures if they are supported by the font.

standardDiscretional Specifies that the text is displayed using standard and discretional ligatures if they are supported by the font.

contextualDiscretional Specifies that the text is displayed using contextual and discretional ligatures if they are supported by the font.

historicalDiscretional Specifies that the text is displayed using historical and discretional ligatures if they are supported by the font.

standardContextualHistorical Specifies that the text is displayed using standard, contextual, and historical ligatures if they are supported by the font.

standardContextualDiscretional Specifies that the text is displayed using standard, contextual, and discretional ligatures if they are supported by the font.

standardHistoricalDiscretional Specifies that the text is displayed using standard, historical, and discretional ligatures if they are supported by the font.

contextualHistoricalDiscretional Specifies that the text is displayed using contextual, historical, and discretional ligatures if they are supported by the font.

all Specifies that the text is displayed using standard, historical, discretional, and contextual ligatures if they are supported by the font.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_Ligatures"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="none"/>

                                    71 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:enumeration value="standard"/> <xsd:enumeration value="contextual"/> <xsd:enumeration value="historical"/> <xsd:enumeration value="discretional"/> <xsd:enumeration value="standardContextual"/> <xsd:enumeration value="standardHistorical"/> <xsd:enumeration value="contextualHistorical"/> <xsd:enumeration value="standardDiscretional"/> <xsd:enumeration value="contextualDiscretional"/> <xsd:enumeration value="historicalDiscretional"/> <xsd:enumeration value="standardContextualHistorical"/> <xsd:enumeration value="standardContextualDiscretional"/> <xsd:enumeration value="standardHistoricalDiscretional"/> <xsd:enumeration value="contextualHistoricalDiscretional"/> <xsd:enumeration value="all"/> </xsd:restriction> </xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.4 ST_LightRigDirection

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_LightRig

A simple type that specifies the direction from which the light rig is positioned relative to the scene. The light rig itself can be made up of multiple lights in any orientation around the shape. This simple type specifies the orientation of the light rig as a whole, and not the individual lights within the rig. This means, for example, that if the direction of the light rig is specified as left, this does not guarantee the light is coming from the left side of the shape; rather, the orientation of the rig as a whole is rotated to the left.

Possible values for this type are listed in the following table. See [ISO/IEC29500-1:2016] section 20.1.10.29 for further details regarding the meaning of the listed values.

Value Meaning

tl Top Left: Light rig is positioned at the top-left of the scene.

t Top: Light rig is positioned at the top of the scene.

tr Top Right: Light rig is positioned at the top-right of the scene.

l Left: Light rig is positioned to the left of the scene.

r Right: Light rig is positioned to the right of the scene.

bl Bottom Left: Light rig is positioned at the bottom left of the scene.

b Bottom: Light rig is positioned at the bottom of the scene.

br Bottom Right: Light rig is positioned at the bottom right of the scene.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_LightRigDirection"> <xsd:restriction base="xsd:token">

         72 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:enumeration value="tl"/> <xsd:enumeration value="t"/> <xsd:enumeration value="tr"/> <xsd:enumeration value="l"/> <xsd:enumeration value="r"/> <xsd:enumeration value="bl"/> <xsd:enumeration value="b"/> <xsd:enumeration value="br"/> </xsd:restriction> </xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.5 ST_LightRigType

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_LightRig

A simple type that specifies a light rig preset to use. A light rig represents a group of lights oriented in a specific way relative to a 3-D scene.

Possible values for this type are listed in the following table. See [ISO/IEC29500-1:2016] section 20.1.10.30 for details regarding the meaning of the listed values.

Value Meaning

legacyFlat1 Legacy Flat 1.

legacyFlat2 Legacy Flat 2.

legacyFlat3 Legacy Flat 3.

legacyFlat4 Legacy Flat 4.

legacyNormal1 Legacy Normal 1.

legacyNormal2 Legacy Normal 2.

legacyNormal3 Legacy Normal 3.

legacyNormal4 Legacy Normal 4.

legacyHarsh1 Legacy Harsh 1.

legacyHarsh2 Legacy Harsh 2.

legacyHarsh3 Legacy Harsh 3.

legacyHarsh4 Legacy Harsh 4.

threePt Three Point.

balanced Balanced.

soft Soft.

harsh Harsh.

flood Flood.

contrasting Contrasting.

                 73 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Value        Meaning

morning      Morning.

sunrise      Sunrise.

sunset       Sunset.

chilly       Chilly.

freezing     Freezing.

flat         Flat.

twoPt        Two Point.

glow         Glow.

brightRoom   Bright Room.



The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this
simple type.

<xsd:simpleType name="ST_LightRigType">
<xsd:restriction base="xsd:token">
 <xsd:enumeration value="legacyFlat1"/>
 <xsd:enumeration value="legacyFlat2"/>
 <xsd:enumeration value="legacyFlat3"/>
 <xsd:enumeration value="legacyFlat4"/>
 <xsd:enumeration value="legacyNormal1"/>
 <xsd:enumeration value="legacyNormal2"/>
 <xsd:enumeration value="legacyNormal3"/>
 <xsd:enumeration value="legacyNormal4"/>
 <xsd:enumeration value="legacyHarsh1"/>
 <xsd:enumeration value="legacyHarsh2"/>
 <xsd:enumeration value="legacyHarsh3"/>
 <xsd:enumeration value="legacyHarsh4"/>
 <xsd:enumeration value="threePt"/>
 <xsd:enumeration value="balanced"/>
 <xsd:enumeration value="soft"/>
 <xsd:enumeration value="harsh"/>
 <xsd:enumeration value="flood"/>
 <xsd:enumeration value="contrasting"/>
 <xsd:enumeration value="morning"/>
 <xsd:enumeration value="sunrise"/>
 <xsd:enumeration value="sunset"/>
 <xsd:enumeration value="chilly"/>
 <xsd:enumeration value="freezing"/>
 <xsd:enumeration value="flat"/>
 <xsd:enumeration value="twoPt"/>
 <xsd:enumeration value="glow"/>
 <xsd:enumeration value="brightRoom"/>
</xsd:restriction>
</xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.6 ST_LineCap

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

                 74 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

Referenced by: CT_TextOutlineEffect

A simple type that specifies how to cap the ends of lines.

Possible values for this type are listed in the following table.

Value Meaning

rnd Rounded ends. Semi-circle protrudes by half line width.

sq Square protrudes by half line width.

flat Line ends at endpoint.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_LineCap"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="rnd"/> <xsd:enumeration value="sq"/> <xsd:enumeration value="flat"/> </xsd:restriction> </xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.7 ST_NumForm

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_NumForm

A simple type that specifies the form in which to display numerals. Possible values for this type are listed in the following table. For more information about numeral forms, see [ISO/IEC-14496-22].

Value Meaning

default Numerals are displayed in the font’s default form.

lining Lining numerals are displayed if the font supports them.

oldStyle Oldstyle numerals are displayed if the font supports them.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_NumForm"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="default"/> <xsd:enumeration value="lining"/> <xsd:enumeration value="oldStyle"/> </xsd:restriction> </xsd:simpleType>

            75 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.8 ST_NumSpacing

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_NumSpacing

A simple type that specifies the form in which to display numeral spacing.

Possible values for this type are listed in the following table.

Value Meaning

default Specifies that numerals are displayed in the font’s default form.

proportional Specifies that the forms of the numerals designed as proportionally spaced are displayed if supported by the font.

tabular Specifies that the forms of the numerals designed as tabular are displayed if supported by the font.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_NumSpacing"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="default"/> <xsd:enumeration value="proportional"/> <xsd:enumeration value="tabular"/> </xsd:restriction> </xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.9 ST_OnOff

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_LinearShadeProperties, CT_StyleSet, CT_OnOff

A simple type that specifies a value for a binary (true or false) property.

Possible values for this type are listed in the following table.

Value Meaning

true Specifies the value is true.

false Specifies the value is false.

0 Specifies the value is false.

1 Specifies the value is true.

                76 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_OnOff"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="true"/> <xsd:enumeration value="false"/> <xsd:enumeration value="0"/> <xsd:enumeration value="1"/> </xsd:restriction> </xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.10 ST_PathShadeType

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_PathShadeProperties

A simple type that specifies the shape to follow for a path gradient shade.

Possible values for this type are listed in the following table.

Value Meaning

shape Gradient follows a shape path.

circle Gradient follows a circular path.

rect Gradient follows a rectangular path.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_PathShadeType"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="shape"/> <xsd:enumeration value="circle"/> <xsd:enumeration value="rect"/> </xsd:restriction> </xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.11 ST_PenAlignment

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_TextOutlineEffect

A simple type that specifies the pen alignment type to be used.

Possible values for this type are listed in the following table.

           77 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Value Meaning

ctr Center pen. The line is drawn at the center of the path stroke.

in Inset pen. The pen is aligned along the inside of the path.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_PenAlignment"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="ctr"/> <xsd:enumeration value="in"/> </xsd:restriction> </xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.12 ST_PresetCameraType

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_Camera

A simple type that specifies an algorithmic method for setting camera properties.

Possible values for this type are listed in the following table. See [ISO/IEC29500-1:2016] section 20.1.10.47 for details regarding the meaning of the listed values.

Value Meaning

legacyObliqueTopLeft Legacy Oblique Top Left.

legacyObliqueTop Legacy Oblique Top.

legacyObliqueTopRight Legacy Oblique Top Right.

legacyObliqueLeft Legacy Oblique Left.

legacyObliqueFront Legacy Oblique Front.

legacyObliqueRight Legacy Oblique Right.

legacyObliqueBottomLeft Legacy Oblique Bottom Left.

legacyObliqueBottom Legacy Oblique Bottom.

legacyObliqueBottomRight Legacy Oblique Bottom Right.

legacyPerspectiveTopLeft Legacy Perspective Top Left.

legacyPerspectiveTop Legacy Perspective Top.

legacyPerspectiveTopRight Legacy Perspective Top Right.

legacyPerspectiveLeft Legacy Perspective Left.

legacyPerspectiveFront Legacy Perspective Front.

                              78 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Value Meaning

legacyPerspectiveRight Legacy Perspective Right.

legacyPerspectiveBottomLeft Legacy Perspective Bottom Left.

legacyPerspectiveBottom Legacy Perspective Bottom.

legacyPerspectiveBottomRight Legacy Perspective Bottom Right.

orthographicFront Orthographic Front.

isometricTopUp Isometric Top Up.

isometricTopDown Isometric Top Down.

isometricBottomUp Isometric Bottom Up.

isometricBottomDown Isometric Bottom Down.

isometricLeftUp Isometric Left Up.

isometricLeftDown Isometric Left Down.

isometricRightUp Isometric Right Up.

isometricRightDown Isometric Right Down.

isometricOffAxis1Left Isometric Off Axis 1 Left.

isometricOffAxis1Right Isometric Off Axis 1 Right.

isometricOffAxis1Top Isometric Off Axis 1 Top.

isometricOffAxis2Left Isometric Off Axis 2 Left.

isometricOffAxis2Right Isometric Off Axis 2 Right.

isometricOffAxis2Top Isometric Off Axis 2 Top.

isometricOffAxis3Left Isometric Off Axis 3 Left.

isometricOffAxis3Right Isometric Off Axis 3 Right.

isometricOffAxis3Bottom Isometric Off Axis 3 Bottom.

isometricOffAxis4Left Isometric Off Axis 4 Left.

isometricOffAxis4Right Isometric Off Axis 4 Right.

isometricOffAxis4Bottom Isometric Off Axis 4 Bottom.

obliqueTopLeft Oblique Top Left.

obliqueTop Oblique Top.

obliqueTopRight Oblique Top Right.

obliqueLeft Oblique Left.

obliqueRight Oblique Right.

obliqueBottomLeft Oblique Bottom Left.

obliqueBottom Oblique Bottom.

                               79 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Value Meaning

obliqueBottomRight Oblique Bottom Right.

perspectiveFront Perspective Front.

perspectiveLeft Perspective Left.

perspectiveRight Perspective Right.

perspectiveAbove Perspective Above.

perspectiveBelow Perspective Below.

perspectiveAboveLeftFacing Perspective Above Left Facing.

perspectiveAboveRightFacing Perspective Above Right Facing.

perspectiveContrastingLeftFacing Perspective Contrasting Left Facing.

perspectiveContrastingRightFacing Perspective Contrasting Right Facing.

perspectiveHeroicLeftFacing Perspective Heroic Left Facing.

perspectiveHeroicRightFacing Perspective Heroic Right Facing.

perspectiveHeroicExtremeLeftFacing Perspective Heroic Extreme Left Facing.

perspectiveHeroicExtremeRightFacing Perspective Heroic Extreme Right Facing.

perspectiveRelaxed Perspective Relaxed.

perspectiveRelaxedModerately Perspective Relaxed Moderately.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_PresetCameraType"> <xsd:restriction base="xsd:token"> <xsd:enumeration value="legacyObliqueTopLeft"/> <xsd:enumeration value="legacyObliqueTop"/> <xsd:enumeration value="legacyObliqueTopRight"/> <xsd:enumeration value="legacyObliqueLeft"/> <xsd:enumeration value="legacyObliqueFront"/> <xsd:enumeration value="legacyObliqueRight"/> <xsd:enumeration value="legacyObliqueBottomLeft"/> <xsd:enumeration value="legacyObliqueBottom"/> <xsd:enumeration value="legacyObliqueBottomRight"/> <xsd:enumeration value="legacyPerspectiveTopLeft"/> <xsd:enumeration value="legacyPerspectiveTop"/> <xsd:enumeration value="legacyPerspectiveTopRight"/> <xsd:enumeration value="legacyPerspectiveLeft"/> <xsd:enumeration value="legacyPerspectiveFront"/> <xsd:enumeration value="legacyPerspectiveRight"/> <xsd:enumeration value="legacyPerspectiveBottomLeft"/> <xsd:enumeration value="legacyPerspectiveBottom"/> <xsd:enumeration value="legacyPerspectiveBottomRight"/> <xsd:enumeration value="orthographicFront"/> <xsd:enumeration value="isometricTopUp"/> <xsd:enumeration value="isometricTopDown"/> <xsd:enumeration value="isometricBottomUp"/> <xsd:enumeration value="isometricBottomDown"/> <xsd:enumeration value="isometricLeftUp"/> <xsd:enumeration value="isometricLeftDown"/>

                                      80 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:enumeration value="isometricRightUp"/> <xsd:enumeration value="isometricRightDown"/> <xsd:enumeration value="isometricOffAxis1Left"/> <xsd:enumeration value="isometricOffAxis1Right"/> <xsd:enumeration value="isometricOffAxis1Top"/> <xsd:enumeration value="isometricOffAxis2Left"/> <xsd:enumeration value="isometricOffAxis2Right"/> <xsd:enumeration value="isometricOffAxis2Top"/> <xsd:enumeration value="isometricOffAxis3Left"/> <xsd:enumeration value="isometricOffAxis3Right"/> <xsd:enumeration value="isometricOffAxis3Bottom"/> <xsd:enumeration value="isometricOffAxis4Left"/> <xsd:enumeration value="isometricOffAxis4Right"/> <xsd:enumeration value="isometricOffAxis4Bottom"/> <xsd:enumeration value="obliqueTopLeft"/> <xsd:enumeration value="obliqueTop"/> <xsd:enumeration value="obliqueTopRight"/> <xsd:enumeration value="obliqueLeft"/> <xsd:enumeration value="obliqueRight"/> <xsd:enumeration value="obliqueBottomLeft"/> <xsd:enumeration value="obliqueBottom"/> <xsd:enumeration value="obliqueBottomRight"/> <xsd:enumeration value="perspectiveFront"/> <xsd:enumeration value="perspectiveLeft"/> <xsd:enumeration value="perspectiveRight"/> <xsd:enumeration value="perspectiveAbove"/> <xsd:enumeration value="perspectiveBelow"/> <xsd:enumeration value="perspectiveAboveLeftFacing"/> <xsd:enumeration value="perspectiveAboveRightFacing"/> <xsd:enumeration value="perspectiveContrastingLeftFacing"/> <xsd:enumeration value="perspectiveContrastingRightFacing"/> <xsd:enumeration value="perspectiveHeroicLeftFacing"/> <xsd:enumeration value="perspectiveHeroicRightFacing"/> <xsd:enumeration value="perspectiveHeroicExtremeLeftFacing"/> <xsd:enumeration value="perspectiveHeroicExtremeRightFacing"/> <xsd:enumeration value="perspectiveRelaxed"/> <xsd:enumeration value="perspectiveRelaxedModerately"/> </xsd:restriction> </xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.13 ST_PresetLineDashVal

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_PresetLineDashProperties

A simple type that specifies preset line dash value.

Possible values for this type are listed in the following table.

Value Meaning

solid

dot

sysDot

dash

sysDash

 81 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Value Meaning

lgDash

dashDot

sysDashDot

lgDashDot

lgDashDotDot

sysDashDotDot

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_PresetLineDashVal"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="solid"/> <xsd:enumeration value="dot"/> <xsd:enumeration value="sysDot"/> <xsd:enumeration value="dash"/> <xsd:enumeration value="sysDash"/> <xsd:enumeration value="lgDash"/> <xsd:enumeration value="dashDot"/> <xsd:enumeration value="sysDashDot"/> <xsd:enumeration value="lgDashDot"/> <xsd:enumeration value="lgDashDotDot"/> <xsd:enumeration value="sysDashDotDot"/> </xsd:restriction> </xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.14 ST_PresetMaterialType

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_Props3D

A simple type that specifies the surface appearance. Possible values for this type are listed in the following table. See [ISO/IEC29500-1:2016] section 20.1.10.50 for details regarding the meaning of the listed values.

Value Meaning

legacyMatte Legacy matte.

legacyPlastic Legacy plastic.

legacyMetal Legacy metal.

legacyWireframe Legacy wireframe.

matte Matte.

plastic Plastic.

                   82 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Value               Meaning

metal               Metal.

warmMatte           Warm matte.

translucentPowder   Translucent powder.

powder              Powder.

dkEdge              Dark edge.

softEdge            Soft edge.

clear               Clear.

flat                Flat.

softmetal           Soft metal.

                    This value has the following characteristics:
                    Specular Color: white.
                    Specular Power value: 40.
none                Ambient Color: shape fill color.
                    Emissive Color: black.

                    Used when other attributes and elements of the parent are 0 to set the parent property to
                    empty.



The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this
simple type.

<xsd:simpleType name="ST_PresetMaterialType">
 <xsd:restriction base="xsd:token">
  <xsd:enumeration value="legacyMatte"/>
  <xsd:enumeration value="legacyPlastic"/>
  <xsd:enumeration value="legacyMetal"/>
  <xsd:enumeration value="legacyWireframe"/>
  <xsd:enumeration value="matte"/>
  <xsd:enumeration value="plastic"/>
  <xsd:enumeration value="metal"/>
  <xsd:enumeration value="warmMatte"/>
  <xsd:enumeration value="translucentPowder"/>
  <xsd:enumeration value="powder"/>
  <xsd:enumeration value="dkEdge"/>
  <xsd:enumeration value="softEdge"/>
  <xsd:enumeration value="clear"/>
  <xsd:enumeration value="flat"/>
  <xsd:enumeration value="softmetal"/>
  <xsd:enumeration value="none"/>
 </xsd:restriction>
</xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.15 ST_RectAlignment

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

                        83 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

Referenced by: CT_Shadow, CT_Reflection

A simple type that specifies how to position two rectangles relative to each other.

Possible values for this type are listed in the following table.

Value Meaning

     When other attributes and elements of the parent are "0", a value of "none" sets the parent property to

none empty.

     When other attributes are nonzero, a value of "none" is equivalent to "ctr".

tl Top Left.

t Top.

tr Top Right.

l Left.

ctr Center.

r Right.

bl Bottom Left.

b Bottom.

br Bottom Right.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_RectAlignment"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="none"/> <xsd:enumeration value="tl"/> <xsd:enumeration value="t"/> <xsd:enumeration value="tr"/> <xsd:enumeration value="l"/> <xsd:enumeration value="ctr"/> <xsd:enumeration value="r"/> <xsd:enumeration value="bl"/> <xsd:enumeration value="b"/> <xsd:enumeration value="br"/> </xsd:restriction> </xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.6.4.16 ST_SchemeColorVal

Target namespace: http://schemas.microsoft.com/office/word/2010/wordml

Referenced by: CT_SchemeColor

A simple type that represents a scheme color value.

         84 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Possible values for this type are listed in the following table. See [ISO/IEC29500-1:2016] section 20.1.10.54 for details about the meaning of each value.

Value Meaning

bg1 Semantic background color.

tx1 Semantic text color.

bg2 Semantic additional background color.

tx2 Semantic additional text color.

accent1 Extra scheme color 1.

accent2 Extra scheme color 2.

accent3 Extra scheme color 3.

accent4 Extra scheme color 4.

accent5 Extra scheme color 5.

accent6 Extra scheme color 6.

hlink Regular hyperlink color.

folHlink Followed hyperlink color.

dk1 Main dark color 1.

lt1 Main light color 1.

dk2 Main dark color 2.

lt2 Main light color 2.

phClr Style Color. A color used in theme definitions that means to use the color of the style.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this simple type.

<xsd:simpleType name="ST_SchemeColorVal"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="bg1"/> <xsd:enumeration value="tx1"/> <xsd:enumeration value="bg2"/> <xsd:enumeration value="tx2"/> <xsd:enumeration value="accent1"/> <xsd:enumeration value="accent2"/> <xsd:enumeration value="accent3"/> <xsd:enumeration value="accent4"/> <xsd:enumeration value="accent5"/> <xsd:enumeration value="accent6"/> <xsd:enumeration value="hlink"/> <xsd:enumeration value="folHlink"/> <xsd:enumeration value="dk1"/> <xsd:enumeration value="lt1"/> <xsd:enumeration value="dk2"/> <xsd:enumeration value="lt2"/> <xsd:enumeration value="phClr"/> </xsd:restriction>

            85 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

</xsd:simpleType>

See section 5.1 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.7 http://schemas.microsoft.com/office/word/2015/wordml/symex

2.7.1 Elements

2.7.1.1 symEx

Target namespace: http://schemas.microsoft.com/office/word/2015/wordml/symex

A CT_SymEx (section 2.7.3.1) element that specifies the presence of a symbol character at the current location in the run's content. It is similar to the sym element (as specified in [ISO/IEC29500- 1:2016] section 17.3.3.30) except that the char attribute is an ST_LongHexNumber (as specified by [ISO/IEC29500-1:2016] section 17.18.50) attribute instead of an ST_ShortHexNumber (as specified in [ISO/IEC29500-1:2016] section 17.18.79).

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="symEx" type="CT_SymEx"/>

See section 5.3 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.7.2 Attributes

None.

2.7.3 Complex Types

2.7.3.1 CT_SymEx

Target namespace: http://schemas.microsoft.com/office/word/2015/wordml/symex

Referenced by: symEx

The CT_SymEx complex type specifies the properties of an extended symbol character (as specified in section 2.7.1.1).

Attributes:

font: An ST_String (as specified in [ISO/IEC29500-1:2016] section 22.9.2.13) attribute that specifies the name of the font with which the character is to be rendered.

char: An ST_LongHexNumber (as specified by [ISO/IEC29500-1:2016] section 17.18.50) attribute that specifies the Unicode character code of the symbol character.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_SymEx">
  <xsd:attribute name="font" type="w12:ST_String"/>
  <xsd:attribute name="char" type="w12:ST_LongHexNumber"/>

       86 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

</xsd:complexType>

See section 5.3 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.7.4 Simple Types

None.

2.8 http://schemas.microsoft.com/office/word/2016/wordml/cid

2.8.1 Elements

2.8.1.1 commentsIds

Target namespace: http://schemas.microsoft.com/office/word/2016/wordml/cid

The commentsIds global element<59> is a CT_CommentsIds element that specifies additional identification information for all the comments in the document. It is the root element of the commentsIds (section 2.1.4) part of a WordprocessingML document.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="commentsIds" type="CT_CommentsIds"/>

See section 5.4 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.8.2 Attributes

2.8.2.1 durableId

Target namespace: http://schemas.microsoft.com/office/word/2016/wordml/cid

An ST_LongHexNumber (as specified by [ISO/IEC29500-1:2016] section 17.18.50) attribute that specifies the identifier for the associated w:num. Values MUST be greater than 0 and less than 0x7FFFFFFF. Values do not need to be sequential.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this attribute.

<xsd:attribute name="durableId" type="w12:ST_LongHexNumber"/>

See section 5.4 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.8.2.2 durableId

Target namespace: http://schemas.microsoft.com/office/word/2016/wordml/cid

An ST_DecimalNumber (as specified by [ISO/IEC29500-1:2016] section 17.18.10) attribute that specifies the identifier for the associated w:num. Values MUST be greater than 0 and less than 2147483647. Values do not need to be sequential.

87 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this attribute.

<xsd:attribute name="durableId" type="w12:ST_DecimalNumber" use="optional"/>

See section 5.4 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.8.3 Complex Types

2.8.3.1 CT_CommentId

Target namespace: http://schemas.microsoft.com/office/word/2016/wordml/cid

Referenced by: CT_CommentsIds

The CT_CommentId complex type<60> specifies additional identification information for a single comment in the document.

Attributes:

paraId: An ST_LongHexNumber (as specified by [ISO/IEC29500-1:2016] section 17.18.50) attribute that specifies the paraId (section 2.6.2.3) of the last paragraph of the associated comment.

durableId: An ST_LongHexNumber (as specified by [ISO/IEC29500-1:2016] section 17.18.50) attribute that specifies the identifier for the associated comment. Values MUST be greater than 0 and less than 0x7FFFFFFF.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_CommentId"> <xsd:attribute name="paraId" type="w12:ST_LongHexNumber" use="required"/> <xsd:attribute name="durableId" type="w12:ST_LongHexNumber" use="required"/> </xsd:complexType>

See section 5.4 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.8.3.2 CT_CommentsIds

Target namespace: http://schemas.microsoft.com/office/word/2016/wordml/cid

Referenced by: commentsIds

The CT_CommentsIds complex type<61> specifies additional identification information for all the comments defined in the document.

Child Elements:

commentId: A CT_CommentId element that specifies additional identification information for a single comment in the document.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_CommentsIds"> xsd:sequence <xsd:element name="commentId" type="CT_CommentId" minOccurs="0" maxOccurs="unbounded"/>

      88 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

    </xsd:sequence>
</xsd:complexType>

See section 5.4 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.8.4 Simple Types

None.

2.9 http://schemas.microsoft.com/office/word/2018/wordml

2.9.1 Elements

None.

2.9.2 Attributes

None.

2.9.3 Complex Types

2.9.3.1 CT_Extension

Target namespace: http://schemas.microsoft.com/office/word/2018/wordml

Referenced by: CT_ExtensionList

A complex type that specifies an extension.

Attributes:

uri: A token ([XMLSCHEMA2/2] section 3.3.2) attribute that specifies the identifier for the extension.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_Extension">
     <xsd:sequence>
   <xsd:any processContents="lax"/>
  </xsd:sequence>
  <xsd:attribute name="uri" type="xsd:token"/>
   </xsd:complexType>

See section 5.5 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.9.3.2 CT_ExtensionList

Target namespace: http://schemas.microsoft.com/office/word/2018/wordml

Referenced by: CT_CommentExtensible, CT_CommentsExtensible

A complex type that specifies a list of extensions.

Child Elements:

       89 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

ext: A CT_Extension element that specifies an extension.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_ExtensionList"> xsd:sequence <xsd:element name="ext" type="CT_Extension" minOccurs="0" maxOccurs="unbounded"/> </xsd:sequence> </xsd:complexType>

See section 5.5 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.9.4 Simple Types

None.

2.10 http://schemas.microsoft.com/office/word/2018/wordml/cex

2.10.1 Elements

2.10.1.1 commentsExtensible

Target namespace: http://schemas.microsoft.com/office/word/2018/wordml/cex

A CT_CommentsExtensible element that specifies additional information about comments in the document. It is the root element of the commentsExtensible part (section 2.1.5).

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this element.

<xsd:element name="commentsExtensible" type="CT_CommentsExtensible"/>

See section 5.6 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.10.2 Attributes

None.

2.10.3 Complex Types

2.10.3.1 CT_CommentExtensible

Target namespace: http://schemas.microsoft.com/office/word/2018/wordml/cex

Referenced by: CT_CommentsExtensible

A complex type that specifies additional information for a single comment.

Child Elements:

extLst: A CT_ExtensionList element that specifies the list of extensions for the comment.

Attributes:

       90 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

durableId: An ST_LongHexNumber ([ISO/IEC29500-1:2016] section 17.18.50) attribute that specifies the durableId (section 2.8.3.1) of the associated comment.

dateUtc: An ST_DateTime ([ISO/IEC29500-1:2016] section 17.18.9) attribute that specifies date information for the comment. Unlike the date attribute of a comment element ([ISO/IEC29500- 1:2016] section 17.13.4.2), the dateUtc attribute is defined to be in the UTC time zone.

intelligentPlaceholder: An ST_OnOff ([ISO/IEC29500-1:2016] section 22.9.2.7) attribute that when true specifies that the comment is a follow-up. The default value is false. The attribute MUST NOT be present on comments that are replies as specified by the paraIdParent attribute of an associated element of type CT_CommentEx (section 2.5.3.1).

When intelligentPlaceholder is true, the content of the comment SHOULD be ignored.<62>

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_CommentExtensible"> xsd:sequence <xsd:element name="extLst" type="w16:CT_ExtensionList" minOccurs="0" maxOccurs="1"/> </xsd:sequence> <xsd:attribute name="durableId" type="w12:ST_LongHexNumber" use="required"/> <xsd:attribute name="dateUtc" type="w12:ST_DateTime" use="optional"/> <xsd:attribute name="intelligentPlaceholder" type="w12:ST_OnOff" use="optional"/> </xsd:complexType>

See section 5.6 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.10.3.2 CT_CommentsExtensible

Target namespace: http://schemas.microsoft.com/office/word/2018/wordml/cex

Referenced by: commentsExtensible

A complex type that specifies additional information about comments in the document.

Child Elements:

commentExtensible: A CT_CommentExtensible element that specifies additional information about a single comment.

extLst: A CT_ExtensionList element that specifies a list of extensions.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

<xsd:complexType name="CT_CommentsExtensible"> xsd:sequence <xsd:element name="commentExtensible" type="CT_CommentExtensible" minOccurs="0" maxOccurs="unbounded"/> <xsd:element name="extLst" type="w16:CT_ExtensionList" minOccurs="0" maxOccurs="1"/> </xsd:sequence> </xsd:complexType>

See section 5.6 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.10.4 Simple Types

None.

     91 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

2.11 http://schemas.microsoft.com/office/word/2020/wordml/sdtdatahash

2.11.1 Elements

None.

2.11.2 Attributes

2.11.2.1 storeItemChecksum

Target namespace: http://schemas.microsoft.com/office/word/2020/wordml/sdtdatahash

An ST_String ([ISO/IEC29500-1:2016] section 22.9.2.13) attribute that specifies a base64 encoded cyclic redundancy check (CRC) checksum computed using the algorithm MsoCrc32Compute ([MS- OSHARED] section 2.4.3). The checksum is computed using the data stream of the corresponding uncompressed and unencrypted custom XML data part. This checksum is stored in base64 encoding.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this attribute.

<xsd:attribute name="storeItemChecksum" type="w12:ST_String"/>

See section 5.7 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.11.3 Complex Types

None.

2.11.4 Simple Types

None.

2.12 http://schemas.microsoft.com/office/word/2023/wordml/word16du

2.12.1 Elements

None.

2.12.2 Attributes

2.12.2.1 dateUtc

Target namespace: http://schemas.microsoft.com/office/word/2023/wordml/word16du

An xsd:dateTime ([XMLSCHEMA2/2] section 3.2.7) attribute that specifies date information for a tracked change. This attribute is defined to be in the UTC time zone.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this attribute.

<xsd:attribute name="dateUtc" type="xsd:dateTime"/>

92 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

See section 5.8 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.12.3 Complex Types

None.

2.12.4 Simple Types

None.

2.13 http://schemas.microsoft.com/office/word/2024/wordml/sdtformatlock

2.13.1 Elements

None.

2.13.2 Attributes

2.13.2.1 formattingAllowed

Target namespace: http://schemas.microsoft.com/office/word/2024/wordml/sdtformatlock

An ST_OnOff ([ECMA-376] section 22.9.2.7) attribute that specifies whether the content control is restricted to formatting. This attribute is applicable only when used in combination with contentLocked or sdtContentLocked.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this attribute.

<xsd:attribute name="formattingAllowed" type="w12:ST_OnOff"/>

See section 5.9 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).

2.13.3 Complex Types

None.

2.13.4 Simple Types

None.

93 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

3 Structure Examples

3.1 Glowing Text

This example shows a usage of an extended element to indicate glowing text. See section 2.2.1 for more information. Consider the following XML, showing the complete contents of the Main Document Part (see [ISO/IEC29500-1:2016] section 11.3.10) of a word processing document.

    <wd:document
  xmlns:wd="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
  xmlns:w14="http://schemas.microsoft.com/office/word/2010/wordml"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  mc:Ignorable="w14">
  <wd:body>
       <wd:p>
   <wd:r>
     <wd:rPr>
      <w14:glow w14:rad="228600">
           <w14:schemeClr w14:val="accent6">
            <w14:alpha w14:val="60000"/>
            <w14:satMod w14:val="175000"/>
           </w14:schemeClr>
      </w14:glow>
     </wd:rPr>
     <wd:t>glowing</wd:t>
   </wd:r>
   <wd:r>
     <wd:t xml:space="preserve"> text.</wd:t>
   </wd:r>
  </wd:p>
  </wd:body>
   </wd:document>

The glowing text is specified by the glow element, as a child of the rPr element (see [ISO/IEC29500- 1:2016] section 17.3.2.28). Also, the Ignorable attribute (see [ISO/IEC29500-3:2015] section 7.2) is used to maintain compatibility with ISO/IEC-29500 implementations. The prefix w14 is specified in the value of this attribute, which is the prefix used for the glow element.

3.2 Stylistic Sets

This example shows a usage of an extended element to indicate enabled stylistic sets and ligatures. See section 2.2.1 for more information. Consider the following XML, showing the complete contents of the Main Document Part (see [ISO/IEC29500-1:2016] section 11.3.10) of a word processing document.

    <wd:document
  xmlns:wd="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
  xmlns:w14="http://schemas.microsoft.com/office/word/2010/wordml"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  mc:Ignorable="w14">
  <wd:body>
  <wd:p>
   <wd:r>
     <wd:rPr>
      <w14:ligatures w14:val="standardContextual"/>
      <w14:stylisticSets>
           <w14:styleSet w14:id="1"/>
           <w14:styleSet w14:id="4"/>
      </w14:stylisticSets>
     </wd:rPr>
     <wd:t>Office</wd:t>

                94 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

</wd:r> </wd:p> </wd:body> </wd:document>

The ligatures child of the rPr element (see [ISO/IEC29500-1:2016] section 17.3.2.28) specifies that the font makes use of standard and contextual ligatures if they are supported by the font. Furthermore, the stylisticSets child specifies that stylistic sets 1 and 4 are enabled. Also, the Ignorable attribute (see [ISO/IEC29500-3:2015] section 7.2) is used to maintain compatibility with ISO/IEC-29500 implementations. The prefix w14 is specified in the value of this attribute, which is the prefix used for the ligatures and stylisticSets elements.

95 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

4 Security Considerations

4.1 Security Considerations for Implementers

None.

4.2 Index of Security Fields

None.

      96 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

5 Appendix A: Full XML Schemas

For ease of implementation, this section provides the full W3C XML Schemas for the new elements, attributes, complex types, and simple types specified in the preceding sections. Any schema references to namespaces included in ISO/IEC-29500:2008 refer specifically to the transitional schemas as specified in [ISO/IEC29500-4:2016].

Schema name Prefix Section

http://schemas.microsoft.com/office/word/2012/wordml Schema None. 5.2

http://schemas.microsoft.com/office/word/2016/wordml/cid Schema None. 5.4

http://schemas.microsoft.com/office/word/2015/wordml/symex Schema None. 5.3

http://schemas.microsoft.com/office/word/2020/wordml/sdtdatahash Schema None. 5.7

http://schemas.microsoft.com/office/word/2024/wordml/sdtformatlock Schema None. 5.9

http://schemas.microsoft.com/office/word/2023/wordml/word16du Schema None. 5.8

http://schemas.microsoft.com/office/word/2010/wordml Schema None. 5.1

http://schemas.microsoft.com/office/word/2018/wordml Schema None. 5.5

http://schemas.microsoft.com/office/word/2018/wordml/cex Schema None. 5.6

5.1 http://schemas.microsoft.com/office/word/2010/wordml Schema

 <xsd:schema attributeFormDefault="qualified" blockDefault="#all"
 elementFormDefault="qualified"
 targetNamespace="http://schemas.microsoft.com/office/word/2010/wordml"
 xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"
 xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
 xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 xmlns:w12="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns="http://schemas.microsoft.com/office/word/2010/wordml">
  <xsd:import schemaLocation="oartbasetypes.xsd"
 namespace="http://schemas.openxmlformats.org/drawingml/2006/main"/>
  <xsd:import schemaLocation="oartsplineproperties.xsd"
 namespace="http://schemas.openxmlformats.org/drawingml/2006/main"/>
  <xsd:import id="rel" schemaLocation="orel.xsd"
 namespace="http://schemas.openxmlformats.org/officeDocument/2006/relationships"/>
  <xsd:import id="w" schemaLocation="word12.xsd"
 namespace="http://schemas.openxmlformats.org/wordprocessingml/2006/main"/>
  <xsd:complexType name="CT_LongHexNumber">
   <xsd:attribute name="val" type="w:ST_LongHexNumber" use="required"/>
  </xsd:complexType>
  <xsd:simpleType name="ST_OnOff">
   <xsd:restriction base="xsd:string">
    <xsd:enumeration value="true"/>
    <xsd:enumeration value="false"/>
    <xsd:enumeration value="0"/>
    <xsd:enumeration value="1"/>
   </xsd:restriction>
  </xsd:simpleType>
  <xsd:complexType name="CT_OnOff">
   <xsd:attribute name="val"     type="ST_OnOff"/>
  </xsd:complexType>
  <xsd:element name="docId" type="CT_LongHexNumber"/>
  <xsd:element name="conflictMode" type="CT_OnOff"/>

                                                                                  97 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:attributeGroup name="AG_Parids"> <xsd:attribute name="paraId" type="w:ST_LongHexNumber"/> <xsd:attribute name="textId" type="w:ST_LongHexNumber"/> </xsd:attributeGroup> <xsd:attribute name="anchorId" type="w:ST_LongHexNumber"/> <xsd:attribute name="noSpellErr" type="w:ST_OnOff"/> <xsd:element name="customXmlConflictInsRangeStart" type="w:CT_TrackChange"/> <xsd:element name="customXmlConflictInsRangeEnd" type="w:CT_Markup"/> <xsd:element name="customXmlConflictDelRangeStart" type="w:CT_TrackChange"/> <xsd:element name="customXmlConflictDelRangeEnd" type="w:CT_Markup"/> <xsd:group name="EG_RunLevelConflicts"> xsd:sequence <xsd:element name="conflictIns" type="w:CT_RunTrackChange" minOccurs="0"/> <xsd:element name="conflictDel" type="w:CT_RunTrackChange" minOccurs="0"/> </xsd:sequence> </xsd:group> <xsd:group name="EG_Conflicts"> xsd:choice <xsd:element name="conflictIns" type="w:CT_TrackChange" minOccurs="0"/> <xsd:element name="conflictDel" type="w:CT_TrackChange" minOccurs="0"/> </xsd:choice> </xsd:group> <xsd:complexType name="CT_Percentage"> <xsd:attribute name="val" type="a:ST_Percentage" use="required"/> </xsd:complexType> <xsd:complexType name="CT_PositiveFixedPercentage"> <xsd:attribute name="val" type="a:ST_PositiveFixedPercentage" use="required"/> </xsd:complexType> <xsd:complexType name="CT_PositivePercentage"> <xsd:attribute name="val" type="a:ST_PositivePercentage" use="required"/> </xsd:complexType> <xsd:simpleType name="ST_SchemeColorVal"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="bg1"/> <xsd:enumeration value="tx1"/> <xsd:enumeration value="bg2"/> <xsd:enumeration value="tx2"/> <xsd:enumeration value="accent1"/> <xsd:enumeration value="accent2"/> <xsd:enumeration value="accent3"/> <xsd:enumeration value="accent4"/> <xsd:enumeration value="accent5"/> <xsd:enumeration value="accent6"/> <xsd:enumeration value="hlink"/> <xsd:enumeration value="folHlink"/> <xsd:enumeration value="dk1"/> <xsd:enumeration value="lt1"/> <xsd:enumeration value="dk2"/> <xsd:enumeration value="lt2"/> <xsd:enumeration value="phClr"/> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="ST_RectAlignment"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="none"/> <xsd:enumeration value="tl"/> <xsd:enumeration value="t"/> <xsd:enumeration value="tr"/> <xsd:enumeration value="l"/> <xsd:enumeration value="ctr"/> <xsd:enumeration value="r"/> <xsd:enumeration value="bl"/> <xsd:enumeration value="b"/> <xsd:enumeration value="br"/> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="ST_PathShadeType"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="shape"/>

   98 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:enumeration value="circle"/> <xsd:enumeration value="rect"/> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="ST_LineCap"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="rnd"/> <xsd:enumeration value="sq"/> <xsd:enumeration value="flat"/> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="ST_PresetLineDashVal"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="solid"/> <xsd:enumeration value="dot"/> <xsd:enumeration value="sysDot"/> <xsd:enumeration value="dash"/> <xsd:enumeration value="sysDash"/> <xsd:enumeration value="lgDash"/> <xsd:enumeration value="dashDot"/> <xsd:enumeration value="sysDashDot"/> <xsd:enumeration value="lgDashDot"/> <xsd:enumeration value="lgDashDotDot"/> <xsd:enumeration value="sysDashDotDot"/> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="ST_PenAlignment"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="ctr"/> <xsd:enumeration value="in"/> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="ST_CompoundLine"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="sng"/> <xsd:enumeration value="dbl"/> <xsd:enumeration value="thickThin"/> <xsd:enumeration value="thinThick"/> <xsd:enumeration value="tri"/> </xsd:restriction> </xsd:simpleType> <xsd:complexType name="CT_RelativeRect"> <xsd:attribute name="l" use="optional" type="a:ST_Percentage"/> <xsd:attribute name="t" use="optional" type="a:ST_Percentage"/> <xsd:attribute name="r" use="optional" type="a:ST_Percentage"/> <xsd:attribute name="b" use="optional" type="a:ST_Percentage"/> </xsd:complexType> <xsd:group name="EG_ColorTransform"> xsd:choice <xsd:element name="tint" type="CT_PositiveFixedPercentage"/> <xsd:element name="shade" type="CT_PositiveFixedPercentage"/> <xsd:element name="alpha" type="CT_PositiveFixedPercentage"/> <xsd:element name="hueMod" type="CT_PositivePercentage"/> <xsd:element name="sat" type="CT_Percentage"/> <xsd:element name="satOff" type="CT_Percentage"/> <xsd:element name="satMod" type="CT_Percentage"/> <xsd:element name="lum" type="CT_Percentage"/> <xsd:element name="lumOff" type="CT_Percentage"/> <xsd:element name="lumMod" type="CT_Percentage"/> </xsd:choice> </xsd:group> <xsd:complexType name="CT_SRgbColor"> xsd:sequence <xsd:group ref="EG_ColorTransform" minOccurs="0" maxOccurs="unbounded"/> </xsd:sequence> <xsd:attribute name="val" type="w:ST_HexColorRGB" use="required"/> </xsd:complexType> <xsd:complexType name="CT_SchemeColor"> xsd:sequence

   99 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:group ref="EG_ColorTransform" minOccurs="0" maxOccurs="unbounded"/> </xsd:sequence> <xsd:attribute name="val" type="ST_SchemeColorVal" use="required"/> </xsd:complexType> <xsd:group name="EG_ColorChoice"> xsd:choice <xsd:element name="srgbClr" type="CT_SRgbColor"/> <xsd:element name="schemeClr" type="CT_SchemeColor"/> </xsd:choice> </xsd:group> <xsd:complexType name="CT_Color"> xsd:sequence <xsd:group ref="EG_ColorChoice"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="CT_GradientStop"> xsd:sequence <xsd:group ref="EG_ColorChoice"/> </xsd:sequence> <xsd:attribute name="pos" type="a:ST_PositiveFixedPercentage" use="required"/> </xsd:complexType> <xsd:complexType name="CT_GradientStopList"> xsd:sequence <xsd:element name="gs" type="CT_GradientStop" minOccurs="2" maxOccurs="10"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="CT_LinearShadeProperties"> <xsd:attribute name="ang" type="a:ST_PositiveFixedAngle" use="optional"/> <xsd:attribute name="scaled" type="ST_OnOff" use="optional"/> </xsd:complexType> <xsd:complexType name="CT_PathShadeProperties"> xsd:sequence <xsd:element name="fillToRect" type="CT_RelativeRect" minOccurs="0"/> </xsd:sequence> <xsd:attribute name="path" type="ST_PathShadeType" use="optional"/> </xsd:complexType> <xsd:group name="EG_ShadeProperties"> xsd:choice <xsd:element name="lin" type="CT_LinearShadeProperties"/> <xsd:element name="path" type="CT_PathShadeProperties"/> </xsd:choice> </xsd:group> <xsd:complexType name="CT_SolidColorFillProperties"> xsd:sequence <xsd:group ref="EG_ColorChoice" minOccurs="0"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="CT_GradientFillProperties"> xsd:sequence <xsd:element name="gsLst" type="CT_GradientStopList" minOccurs="0"/> <xsd:group ref="EG_ShadeProperties" minOccurs="0"/> </xsd:sequence> </xsd:complexType> <xsd:group name="EG_FillProperties"> xsd:choice <xsd:element name="noFill" type="w:CT_Empty"/> <xsd:element name="solidFill" type="CT_SolidColorFillProperties"/> <xsd:element name="gradFill" type="CT_GradientFillProperties"/> </xsd:choice> </xsd:group> <xsd:complexType name="CT_PresetLineDashProperties"> <xsd:attribute name="val" type="ST_PresetLineDashVal" use="optional"/> </xsd:complexType> <xsd:group name="EG_LineDashProperties"> xsd:choice <xsd:element name="prstDash" type="CT_PresetLineDashProperties"/> </xsd:choice> </xsd:group> <xsd:complexType name="CT_LineJoinMiterProperties">

   100 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:attribute name="lim" type="a:ST_PositivePercentage" use="optional"/> </xsd:complexType> <xsd:group name="EG_LineJoinProperties"> xsd:choice <xsd:element name="round" type="w:CT_Empty"/> <xsd:element name="bevel" type="w:CT_Empty"/> <xsd:element name="miter" type="CT_LineJoinMiterProperties"/> </xsd:choice> </xsd:group> <xsd:simpleType name="ST_PresetCameraType"> <xsd:restriction base="xsd:token"> <xsd:enumeration value="legacyObliqueTopLeft"/> <xsd:enumeration value="legacyObliqueTop"/> <xsd:enumeration value="legacyObliqueTopRight"/> <xsd:enumeration value="legacyObliqueLeft"/> <xsd:enumeration value="legacyObliqueFront"/> <xsd:enumeration value="legacyObliqueRight"/> <xsd:enumeration value="legacyObliqueBottomLeft"/> <xsd:enumeration value="legacyObliqueBottom"/> <xsd:enumeration value="legacyObliqueBottomRight"/> <xsd:enumeration value="legacyPerspectiveTopLeft"/> <xsd:enumeration value="legacyPerspectiveTop"/> <xsd:enumeration value="legacyPerspectiveTopRight"/> <xsd:enumeration value="legacyPerspectiveLeft"/> <xsd:enumeration value="legacyPerspectiveFront"/> <xsd:enumeration value="legacyPerspectiveRight"/> <xsd:enumeration value="legacyPerspectiveBottomLeft"/> <xsd:enumeration value="legacyPerspectiveBottom"/> <xsd:enumeration value="legacyPerspectiveBottomRight"/> <xsd:enumeration value="orthographicFront"/> <xsd:enumeration value="isometricTopUp"/> <xsd:enumeration value="isometricTopDown"/> <xsd:enumeration value="isometricBottomUp"/> <xsd:enumeration value="isometricBottomDown"/> <xsd:enumeration value="isometricLeftUp"/> <xsd:enumeration value="isometricLeftDown"/> <xsd:enumeration value="isometricRightUp"/> <xsd:enumeration value="isometricRightDown"/> <xsd:enumeration value="isometricOffAxis1Left"/> <xsd:enumeration value="isometricOffAxis1Right"/> <xsd:enumeration value="isometricOffAxis1Top"/> <xsd:enumeration value="isometricOffAxis2Left"/> <xsd:enumeration value="isometricOffAxis2Right"/> <xsd:enumeration value="isometricOffAxis2Top"/> <xsd:enumeration value="isometricOffAxis3Left"/> <xsd:enumeration value="isometricOffAxis3Right"/> <xsd:enumeration value="isometricOffAxis3Bottom"/> <xsd:enumeration value="isometricOffAxis4Left"/> <xsd:enumeration value="isometricOffAxis4Right"/> <xsd:enumeration value="isometricOffAxis4Bottom"/> <xsd:enumeration value="obliqueTopLeft"/> <xsd:enumeration value="obliqueTop"/> <xsd:enumeration value="obliqueTopRight"/> <xsd:enumeration value="obliqueLeft"/> <xsd:enumeration value="obliqueRight"/> <xsd:enumeration value="obliqueBottomLeft"/> <xsd:enumeration value="obliqueBottom"/> <xsd:enumeration value="obliqueBottomRight"/> <xsd:enumeration value="perspectiveFront"/> <xsd:enumeration value="perspectiveLeft"/> <xsd:enumeration value="perspectiveRight"/> <xsd:enumeration value="perspectiveAbove"/> <xsd:enumeration value="perspectiveBelow"/> <xsd:enumeration value="perspectiveAboveLeftFacing"/> <xsd:enumeration value="perspectiveAboveRightFacing"/> <xsd:enumeration value="perspectiveContrastingLeftFacing"/> <xsd:enumeration value="perspectiveContrastingRightFacing"/> <xsd:enumeration value="perspectiveHeroicLeftFacing"/> <xsd:enumeration value="perspectiveHeroicRightFacing"/>

   101 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:enumeration value="perspectiveHeroicExtremeLeftFacing"/> <xsd:enumeration value="perspectiveHeroicExtremeRightFacing"/> <xsd:enumeration value="perspectiveRelaxed"/> <xsd:enumeration value="perspectiveRelaxedModerately"/> </xsd:restriction> </xsd:simpleType> <xsd:complexType name="CT_Camera"> <xsd:attribute name="prst" use="required" type="ST_PresetCameraType"/> </xsd:complexType> <xsd:complexType name="CT_SphereCoords"> <xsd:attribute name="lat" type="a:ST_PositiveFixedAngle" use="required"/> <xsd:attribute name="lon" type="a:ST_PositiveFixedAngle" use="required"/> <xsd:attribute name="rev" type="a:ST_PositiveFixedAngle" use="required"/> </xsd:complexType> <xsd:simpleType name="ST_LightRigType"> <xsd:restriction base="xsd:token"> <xsd:enumeration value="legacyFlat1"/> <xsd:enumeration value="legacyFlat2"/> <xsd:enumeration value="legacyFlat3"/> <xsd:enumeration value="legacyFlat4"/> <xsd:enumeration value="legacyNormal1"/> <xsd:enumeration value="legacyNormal2"/> <xsd:enumeration value="legacyNormal3"/> <xsd:enumeration value="legacyNormal4"/> <xsd:enumeration value="legacyHarsh1"/> <xsd:enumeration value="legacyHarsh2"/> <xsd:enumeration value="legacyHarsh3"/> <xsd:enumeration value="legacyHarsh4"/> <xsd:enumeration value="threePt"/> <xsd:enumeration value="balanced"/> <xsd:enumeration value="soft"/> <xsd:enumeration value="harsh"/> <xsd:enumeration value="flood"/> <xsd:enumeration value="contrasting"/> <xsd:enumeration value="morning"/> <xsd:enumeration value="sunrise"/> <xsd:enumeration value="sunset"/> <xsd:enumeration value="chilly"/> <xsd:enumeration value="freezing"/> <xsd:enumeration value="flat"/> <xsd:enumeration value="twoPt"/> <xsd:enumeration value="glow"/> <xsd:enumeration value="brightRoom"/> </xsd:restriction> </xsd:simpleType> <xsd:simpleType name="ST_LightRigDirection"> <xsd:restriction base="xsd:token"> <xsd:enumeration value="tl"/> <xsd:enumeration value="t"/> <xsd:enumeration value="tr"/> <xsd:enumeration value="l"/> <xsd:enumeration value="r"/> <xsd:enumeration value="bl"/> <xsd:enumeration value="b"/> <xsd:enumeration value="br"/> </xsd:restriction> </xsd:simpleType> <xsd:complexType name="CT_LightRig"> xsd:sequence <xsd:element name="rot" type="CT_SphereCoords" minOccurs="0"/> </xsd:sequence> <xsd:attribute name="rig" type="ST_LightRigType" use="required"/> <xsd:attribute name="dir" type="ST_LightRigDirection" use="required"/> </xsd:complexType> <xsd:simpleType name="ST_BevelPresetType"> <xsd:restriction base="xsd:token"> <xsd:enumeration value="relaxedInset"/> <xsd:enumeration value="circle"/> <xsd:enumeration value="slope"/>

   102 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:enumeration value="cross"/> <xsd:enumeration value="angle"/> <xsd:enumeration value="softRound"/> <xsd:enumeration value="convex"/> <xsd:enumeration value="coolSlant"/> <xsd:enumeration value="divot"/> <xsd:enumeration value="riblet"/> <xsd:enumeration value="hardEdge"/> <xsd:enumeration value="artDeco"/> </xsd:restriction> </xsd:simpleType> <xsd:complexType name="CT_Bevel"> <xsd:attribute name="w" type="a:ST_PositiveCoordinate" use="optional"/> <xsd:attribute name="h" type="a:ST_PositiveCoordinate" use="optional"/> <xsd:attribute name="prst" type="ST_BevelPresetType" use="optional"/> </xsd:complexType> <xsd:simpleType name="ST_PresetMaterialType"> <xsd:restriction base="xsd:token"> <xsd:enumeration value="legacyMatte"/> <xsd:enumeration value="legacyPlastic"/> <xsd:enumeration value="legacyMetal"/> <xsd:enumeration value="legacyWireframe"/> <xsd:enumeration value="matte"/> <xsd:enumeration value="plastic"/> <xsd:enumeration value="metal"/> <xsd:enumeration value="warmMatte"/> <xsd:enumeration value="translucentPowder"/> <xsd:enumeration value="powder"/> <xsd:enumeration value="dkEdge"/> <xsd:enumeration value="softEdge"/> <xsd:enumeration value="clear"/> <xsd:enumeration value="flat"/> <xsd:enumeration value="softmetal"/> <xsd:enumeration value="none"/> </xsd:restriction> </xsd:simpleType> <xsd:complexType name="CT_Glow"> xsd:sequence <xsd:group ref="EG_ColorChoice"/> </xsd:sequence> <xsd:attribute name="rad" use="optional" type="a:ST_PositiveCoordinate"/> </xsd:complexType> <xsd:complexType name="CT_Shadow"> xsd:sequence <xsd:group ref="EG_ColorChoice"/> </xsd:sequence> <xsd:attribute name="blurRad" use="optional" type="a:ST_PositiveCoordinate"/> <xsd:attribute name="dist" use="optional" type="a:ST_PositiveCoordinate"/> <xsd:attribute name="dir" use="optional" type="a:ST_PositiveFixedAngle"/> <xsd:attribute name="sx" use="optional" type="a:ST_Percentage"/> <xsd:attribute name="sy" use="optional" type="a:ST_Percentage"/> <xsd:attribute name="kx" use="optional" type="a:ST_FixedAngle"/> <xsd:attribute name="ky" use="optional" type="a:ST_FixedAngle"/> <xsd:attribute name="algn" use="optional" type="ST_RectAlignment"/> </xsd:complexType> <xsd:complexType name="CT_Reflection"> <xsd:attribute name="blurRad" use="optional" type="a:ST_PositiveCoordinate"/> <xsd:attribute name="stA" use="optional" type="a:ST_PositiveFixedPercentage"/> <xsd:attribute name="stPos" use="optional" type="a:ST_PositiveFixedPercentage"/> <xsd:attribute name="endA" use="optional" type="a:ST_PositiveFixedPercentage"/> <xsd:attribute name="endPos" use="optional" type="a:ST_PositiveFixedPercentage"/> <xsd:attribute name="dist" use="optional" type="a:ST_PositiveCoordinate"/> <xsd:attribute name="dir" use="optional" type="a:ST_PositiveFixedAngle"/> <xsd:attribute name="fadeDir" use="optional" type="a:ST_PositiveFixedAngle"/> <xsd:attribute name="sx" use="optional" type="a:ST_Percentage"/> <xsd:attribute name="sy" use="optional" type="a:ST_Percentage"/> <xsd:attribute name="kx" use="optional" type="a:ST_FixedAngle"/> <xsd:attribute name="ky" use="optional" type="a:ST_FixedAngle"/> <xsd:attribute name="algn" use="optional" type="ST_RectAlignment"/>

   103 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

</xsd:complexType> <xsd:complexType name="CT_FillTextEffect"> xsd:sequence <xsd:group ref="EG_FillProperties" minOccurs="0"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="CT_TextOutlineEffect"> xsd:sequence <xsd:group ref="EG_FillProperties" minOccurs="0"/> <xsd:group ref="EG_LineDashProperties" minOccurs="0"/> <xsd:group ref="EG_LineJoinProperties" minOccurs="0"/> </xsd:sequence> <xsd:attribute name="w" use="optional" type="a:ST_LineWidth"/> <xsd:attribute name="cap" use="optional" type="ST_LineCap"/> <xsd:attribute name="cmpd" use="optional" type="ST_CompoundLine"/> <xsd:attribute name="algn" use="optional" type="ST_PenAlignment"/> </xsd:complexType> <xsd:complexType name="CT_Scene3D"> xsd:sequence <xsd:element name="camera" type="CT_Camera"/> <xsd:element name="lightRig" type="CT_LightRig"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="CT_Props3D"> xsd:sequence <xsd:element name="bevelT" type="CT_Bevel" minOccurs="0"/> <xsd:element name="bevelB" type="CT_Bevel" minOccurs="0"/> <xsd:element name="extrusionClr" type="CT_Color" minOccurs="0"/> <xsd:element name="contourClr" type="CT_Color" minOccurs="0"/> </xsd:sequence> <xsd:attribute name="extrusionH" type="a:ST_PositiveCoordinate" use="optional"/> <xsd:attribute name="contourW" type="a:ST_PositiveCoordinate" use="optional"/> <xsd:attribute name="prstMaterial" type="ST_PresetMaterialType" use="optional"/> </xsd:complexType> <xsd:group name="EG_RPrTextEffects"> xsd:sequence <xsd:element name="glow" minOccurs="0" type="CT_Glow"/> <xsd:element name="shadow" minOccurs="0" type="CT_Shadow"/> <xsd:element name="reflection" minOccurs="0" type="CT_Reflection"/> <xsd:element name="textOutline" minOccurs="0" type="CT_TextOutlineEffect"/> <xsd:element name="textFill" minOccurs="0" type="CT_FillTextEffect"/> <xsd:element name="scene3d" minOccurs="0" type="CT_Scene3D"/> <xsd:element name="props3d" minOccurs="0" type="CT_Props3D"/> </xsd:sequence> </xsd:group> <xsd:simpleType name="ST_Ligatures"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="none"/> <xsd:enumeration value="standard"/> <xsd:enumeration value="contextual"/> <xsd:enumeration value="historical"/> <xsd:enumeration value="discretional"/> <xsd:enumeration value="standardContextual"/> <xsd:enumeration value="standardHistorical"/> <xsd:enumeration value="contextualHistorical"/> <xsd:enumeration value="standardDiscretional"/> <xsd:enumeration value="contextualDiscretional"/> <xsd:enumeration value="historicalDiscretional"/> <xsd:enumeration value="standardContextualHistorical"/> <xsd:enumeration value="standardContextualDiscretional"/> <xsd:enumeration value="standardHistoricalDiscretional"/> <xsd:enumeration value="contextualHistoricalDiscretional"/> <xsd:enumeration value="all"/> </xsd:restriction> </xsd:simpleType> <xsd:complexType name="CT_Ligatures"> <xsd:attribute name="val" type="ST_Ligatures" use="required"/> </xsd:complexType> <xsd:simpleType name="ST_NumForm">

   104 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:restriction base="xsd:string"> <xsd:enumeration value="default"/> <xsd:enumeration value="lining"/> <xsd:enumeration value="oldStyle"/> </xsd:restriction> </xsd:simpleType> <xsd:complexType name="CT_NumForm"> <xsd:attribute name="val" type="ST_NumForm" use="required"/> </xsd:complexType> <xsd:simpleType name="ST_NumSpacing"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="default"/> <xsd:enumeration value="proportional"/> <xsd:enumeration value="tabular"/> </xsd:restriction> </xsd:simpleType> <xsd:complexType name="CT_NumSpacing"> <xsd:attribute name="val" type="ST_NumSpacing" use="required"/> </xsd:complexType> <xsd:complexType name="CT_StyleSet"> <xsd:attribute name="id" type="w:ST_UnsignedDecimalNumber" use="required"/> <xsd:attribute name="val" type="ST_OnOff" use="optional"/> </xsd:complexType> <xsd:complexType name="CT_StylisticSets"> <xsd:sequence minOccurs="0"> <xsd:element name="styleSet" minOccurs="0" maxOccurs="unbounded" type="CT_StyleSet"/> </xsd:sequence> </xsd:complexType> <xsd:group name="EG_RPrOpenType"> xsd:sequence <xsd:element name="ligatures" minOccurs="0" type="CT_Ligatures"/> <xsd:element name="numForm" minOccurs="0" type="CT_NumForm"/> <xsd:element name="numSpacing" minOccurs="0" type="CT_NumSpacing"/> <xsd:element name="stylisticSets" minOccurs="0" type="CT_StylisticSets"/> <xsd:element name="cntxtAlts" minOccurs="0" type="CT_OnOff"/> </xsd:sequence> </xsd:group> <xsd:element name="discardImageEditingData" type="CT_OnOff"/> <xsd:element name="defaultImageDpi" type="CT_DefaultImageDpi"/> <xsd:complexType name="CT_DefaultImageDpi"> <xsd:attribute name="val" type="w:ST_DecimalNumber" use="required"/> </xsd:complexType> <xsd:element name="entityPicker" type="w:CT_Empty"/> <xsd:complexType name="CT_SdtCheckboxSymbol"> <xsd:attribute name="font" type="w:ST_String"/> <xsd:attribute name="val" type="w:ST_ShortHexNumber"/> </xsd:complexType> <xsd:complexType name="CT_SdtCheckbox"> xsd:sequence <xsd:element name="checked" type="CT_OnOff" minOccurs="0"/> <xsd:element name="checkedState" type="CT_SdtCheckboxSymbol" minOccurs="0"/> <xsd:element name="uncheckedState" type="CT_SdtCheckboxSymbol" minOccurs="0"/> </xsd:sequence> </xsd:complexType> <xsd:element name="checkbox" type="CT_SdtCheckbox"/> </xsd:schema>

5.2 http://schemas.microsoft.com/office/word/2012/wordml Schema

 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:w12="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 elementFormDefault="qualified" attributeFormDefault="qualified" blockDefault="#all"
 xmlns="http://schemas.microsoft.com/office/word/2012/wordml"
 targetNamespace="http://schemas.microsoft.com/office/word/2012/wordml">
  <xsd:import id="w12"
 namespace="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 schemaLocation="word12.xsd"/>

      105 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<xsd:element name="color" type="w12:CT_Color"/> <xsd:simpleType name="ST_SdtAppearance"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="boundingBox"/> <xsd:enumeration value="tags"/> <xsd:enumeration value="hidden"/> </xsd:restriction> </xsd:simpleType> <xsd:element name="dataBinding" type="w12:CT_DataBinding"/> <xsd:complexType name="CT_SdtAppearance"> <xsd:attribute name="val" type="ST_SdtAppearance"/> </xsd:complexType> <xsd:element name="appearance" type="CT_SdtAppearance"/> <xsd:complexType name="CT_CommentsEx"> xsd:sequence <xsd:element name="commentEx" type="CT_CommentEx" minOccurs="0" maxOccurs="unbounded"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="CT_CommentEx"> <xsd:attribute name="paraId" type="w12:ST_LongHexNumber" use="required"/> <xsd:attribute name="paraIdParent" type="w12:ST_LongHexNumber" use="optional"/> <xsd:attribute name="done" type="w12:ST_OnOff" use="optional"/> </xsd:complexType> <xsd:element name="commentsEx" type="CT_CommentsEx"/> <xsd:complexType name="CT_People"> xsd:sequence <xsd:element name="person" type="CT_Person" minOccurs="0" maxOccurs="unbounded"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="CT_PresenceInfo"> <xsd:attribute name="providerId" type="xsd:string" use="required"/> <xsd:attribute name="userId" type="xsd:string" use="required"/> </xsd:complexType> <xsd:complexType name="CT_Person"> xsd:sequence <xsd:element name="presenceInfo" type="CT_PresenceInfo" minOccurs="0" maxOccurs="1"/> </xsd:sequence> <xsd:attribute name="author" type="w12:ST_String" use="required"/> </xsd:complexType> <xsd:element name="people" type="CT_People"/> <xsd:complexType name="CT_SdtRepeatedSection"> xsd:sequence <xsd:element name="sectionTitle" type="w12:CT_String" minOccurs="0"/> <xsd:element name="doNotAllowInsertDeleteSection" type="w12:CT_OnOff" minOccurs="0"/> </xsd:sequence> </xsd:complexType> <xsd:simpleType name="ST_Guid"> <xsd:restriction base="xsd:token"> <xsd:pattern value="{[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}}"/> </xsd:restriction> </xsd:simpleType> <xsd:complexType name="CT_Guid"> <xsd:attribute name="val" type="ST_Guid"/> </xsd:complexType> <xsd:element name="repeatingSection" type="CT_SdtRepeatedSection"/> <xsd:element name="repeatingSectionItem" type="w12:CT_Empty"/> <xsd:element name="chartTrackingRefBased" type="w12:CT_OnOff"/> <xsd:element name="collapsed" type="w12:CT_OnOff"/> <xsd:element name="docId" type="CT_Guid"/> <xsd:element name="footnoteColumns" type="w12:CT_DecimalNumber"/> <xsd:element name="webExtensionLinked" type="w12:CT_OnOff"/> <xsd:element name="webExtensionCreated" type="w12:CT_OnOff"/> <xsd:attribute name="restartNumberingAfterBreak" type="w12:ST_OnOff"/> </xsd:schema>

  106 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

5.3 http://schemas.microsoft.com/office/word/2015/wordml/symex Schema

 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:w12="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 elementFormDefault="qualified" attributeFormDefault="qualified" blockDefault="#all"
 xmlns="http://schemas.microsoft.com/office/word/2015/wordml/symex"
 targetNamespace="http://schemas.microsoft.com/office/word/2015/wordml/symex">
  <xsd:import id="w12"
 namespace="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 schemaLocation="word12.xsd"/>
  <xsd:complexType name="CT_SymEx">
   <xsd:attribute name="font" type="w12:ST_String"/>
   <xsd:attribute name="char" type="w12:ST_LongHexNumber"/>
  </xsd:complexType>
  <xsd:element name="symEx" type="CT_SymEx"/>
 </xsd:schema>

5.4 http://schemas.microsoft.com/office/word/2016/wordml/cid Schema

 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:w12="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 elementFormDefault="qualified" attributeFormDefault="qualified" blockDefault="#all"
 xmlns="http://schemas.microsoft.com/office/word/2016/wordml/cid"
 targetNamespace="http://schemas.microsoft.com/office/word/2016/wordml/cid">
  <xsd:import id="w12"
 namespace="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 schemaLocation="word12.xsd"/>
  <xsd:attributeGroup name="decimaldurableId">
   <xsd:attribute name="durableId" type="w12:ST_DecimalNumber" use="optional"/>
  </xsd:attributeGroup>
  <xsd:attribute name="durableId" type="w12:ST_LongHexNumber"/>
  <xsd:complexType name="CT_CommentsIds">
   <xsd:sequence>
   <xsd:element name="commentId" type="CT_CommentId" minOccurs="0" maxOccurs="unbounded"/>
   </xsd:sequence>
  </xsd:complexType>
  <xsd:complexType name="CT_CommentId">
   <xsd:attribute name="paraId" type="w12:ST_LongHexNumber" use="required"/>
   <xsd:attribute name="durableId" type="w12:ST_LongHexNumber" use="required"/>
  </xsd:complexType>
  <xsd:element name="commentsIds" type="CT_CommentsIds"/>
 </xsd:schema>

5.5 http://schemas.microsoft.com/office/word/2018/wordml Schema

 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:w12="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 elementFormDefault="qualified" attributeFormDefault="qualified" blockDefault="#all"
 xmlns="http://schemas.microsoft.com/office/word/2018/wordml"
 targetNamespace="http://schemas.microsoft.com/office/word/2018/wordml">
  <xsd:import id="w12"
 namespace="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 schemaLocation="word12.xsd"/>
  <xsd:complexType name="CT_Extension">
   <xsd:sequence>
   <xsd:any processContents="lax"/>
   </xsd:sequence>
   <xsd:attribute name="uri" type="xsd:token"/>
  </xsd:complexType>
  <xsd:complexType name="CT_ExtensionList">
   <xsd:sequence>
   <xsd:element name="ext" type="CT_Extension" minOccurs="0" maxOccurs="unbounded"/>
   </xsd:sequence>
  </xsd:complexType>


       107 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

</xsd:schema>

5.6 http://schemas.microsoft.com/office/word/2018/wordml/cex Schema

 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:w12="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 xmlns:w16="http://schemas.microsoft.com/office/word/2018/wordml"
 elementFormDefault="qualified" attributeFormDefault="qualified" blockDefault="#all"
 xmlns="http://schemas.microsoft.com/office/word/2018/wordml/cex"
 targetNamespace="http://schemas.microsoft.com/office/word/2018/wordml/cex">
  <xsd:import id="w16" namespace="http://schemas.microsoft.com/office/word/2018/wordml"
 schemaLocation="word16.xsd"/>
  <xsd:import id="w12"
 namespace="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 schemaLocation="word12.xsd"/>
  <xsd:complexType name="CT_CommentsExtensible">
   <xsd:sequence>
   <xsd:element name="commentExtensible" type="CT_CommentExtensible" minOccurs="0"
 maxOccurs="unbounded"/>
   <xsd:element name="extLst" type="w16:CT_ExtensionList" minOccurs="0" maxOccurs="1"/>
   </xsd:sequence>
  </xsd:complexType>
  <xsd:complexType name="CT_CommentExtensible">
   <xsd:sequence>
   <xsd:element name="extLst" type="w16:CT_ExtensionList" minOccurs="0" maxOccurs="1"/>
   </xsd:sequence>
   <xsd:attribute name="durableId" type="w12:ST_LongHexNumber" use="required"/>
   <xsd:attribute name="dateUtc" type="w12:ST_DateTime" use="optional"/>
   <xsd:attribute name="intelligentPlaceholder" type="w12:ST_OnOff" use="optional"/>
  </xsd:complexType>
  <xsd:element name="commentsExtensible" type="CT_CommentsExtensible"/>
 </xsd:schema>

5.7 http://schemas.microsoft.com/office/word/2020/wordml/sdtdatahash Schema

 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:w12="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 elementFormDefault="qualified" attributeFormDefault="qualified" blockDefault="#all"
 xmlns="http://schemas.microsoft.com/office/word/2020/wordml/sdtdatahash"
 targetNamespace="http://schemas.microsoft.com/office/word/2020/wordml/sdtdatahash">
  <xsd:import id="w12"
 namespace="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
 schemaLocation="word12.xsd"/>
  <xsd:attribute name="storeItemChecksum" type="w12:ST_String"/>
 </xsd:schema>

5.8 http://schemas.microsoft.com/office/word/2023/wordml/word16du Schema

 <xsd:schema xmlns="http://schemas.microsoft.com/office/word/2023/wordml/word16du"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema" blockDefault="#all"
 elementFormDefault="qualified" attributeFormDefault="qualified"
 targetNamespace="http://schemas.microsoft.com/office/word/2023/wordml/word16du">
  <xsd:attribute name="dateUtc" type="xsd:dateTime"/>
 </xsd:schema>

5.9 http://schemas.microsoft.com/office/word/2024/wordml/sdtformatlock Schema

 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:w12="http://schemas.openxmlformats.org/wordprocessingml/2006/main"

       108 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

elementFormDefault="qualified" attributeFormDefault="qualified" blockDefault="#all" xmlns="http://schemas.microsoft.com/office/word/2024/wordml/sdtformatlock" targetNamespace="http://schemas.microsoft.com/office/word/2024/wordml/sdtformatlock"> <xsd:import id="w12" namespace="http://schemas.openxmlformats.org/wordprocessingml/2006/main" schemaLocation="word12.xsd"/> <xsd:attribute name="formattingAllowed" type="w12:ST_OnOff"/> </xsd:schema>

109 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

6 Appendix B: Product Behavior

The information in this specification is applicable to the following Microsoft products or supplemental software. References to product versions include updates to those products.

Microsoft Office Word 2007

Microsoft Word 2010

Microsoft Word 2013

Microsoft Word 2016

Microsoft Word 2019

Microsoft Word 2021

Microsoft Word LTSC 2024

Exceptions, if any, are noted in this section. If an update version, service pack or Knowledge Base (KB) number appears with a product name, the behavior changed in that update. The new behavior also applies to subsequent updates unless otherwise specified. If a product edition appears with the product version, behavior is different in that product edition.

Unless otherwise specified, any statement of optional behavior in this specification that is prescribed using the terms "SHOULD" or "SHOULD NOT" implies product behavior in accordance with the SHOULD or SHOULD NOT prescription. Unless otherwise specified, the term "MAY" implies that the product does not follow the prescription.

<1> Section 2.1.1: Office Word 2007 treats this part as an unknown relationship as specified in [ISO/IEC29500-1:2016] section 9.1.7.

<2> Section 2.1.1: This part is written out only by Microsoft Word 2010. Word 2013 and later will not write out this part.

<3> Section 2.1.2: This part is not available in Word 2010 and earlier.

<4> Section 2.1.3: This part is not available in Word 2010 and earlier.

<5> Section 2.1.4: This part is not available in Word 2013 and earlier.

<6> Section 2.1.5: This part is not available in Word 2016 and earlier.

<7> Section 2.2.8: This extension is not available in Word 2010 and earlier.

<8> Section 2.2.9: This extension is not available in Word 2010 and earlier.

<9> Section 2.2.10: This extension is not available in Word 2010 and earlier.

<10> Section 2.2.11: This extension is not available in Word 2013 and earlier.

<11> Section 2.2.12: This extension is only available when used with Microsoft Office 365.

<12> Section 2.3.4: This element is not available in Word 2010 and earlier.

<13> Section 2.3.5: Word 2010 ignores a compatSetting element with a val attribute whose value is 15.

<14> Section 2.3.6: This element is not available in Word 2010 and earlier.

<15> Section 2.3.7: This element is not available in Word 2013 and earlier

                      110 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

<16> Section 2.3.8: This element is not available in Word 2013 and earlier.

<17> Section 2.5.1.1: This element is not available in Word 2010 and earlier.

<18> Section 2.5.1.2: This element is not available in Word 2010 and earlier.

<19> Section 2.5.1.3: This element is not available in Word 2010 and earlier.

<20> Section 2.5.1.4: This element is not available in Word 2010 and earlier.

<21> Section 2.5.1.5: This element is not available in Word 2010 and earlier.

<22> Section 2.5.1.6: This element is not available in Word 2010 and earlier.

<23> Section 2.5.1.7: This element is not available in Word 2010 and earlier.

<24> Section 2.5.1.8: This element is not available in Word 2010 and earlier.

<25> Section 2.5.1.9: This element is not available in Word 2010 and earlier.

<26> Section 2.5.1.10: This element is not available in Word 2010 and earlier.

<27> Section 2.5.1.11: This element is not available in Word 2010 and earlier.

<28> Section 2.5.1.12: This element is not available in Word 2010 and earlier.

<29> Section 2.5.1.13: This element is not available in Word 2010 and earlier.

<30> Section 2.5.2.1: This attribute is not available in Word 2010 and earlier.

<31> Section 2.5.3.1: This type is not available in Word 2010 and earlier.

<32> Section 2.5.3.2: This type is not available in Word 2010 and earlier.

<33> Section 2.5.3.4: This type is not available in Word 2010 and earlier.

<34> Section 2.5.3.5: This type is not available in Word 2010 and earlier.

<35> Section 2.5.3.6: This type is not available in Word 2010 and earlier.

<36> Section 2.5.3.6: This value is only available when used with Office 365.

<37> Section 2.5.3.6: Older versions of Microsoft Word Online on Office 365 emitted values consisting of a unique identifier followed by the constant text "@LIVE.COM".

<38> Section 2.5.3.7: This type is not available in Word 2010 and earlier.

<39> Section 2.5.3.8: This type is not available in Word 2010 and earlier.

<40> Section 2.5.4.2: This type is not available in Word 2010 and earlier.

<41> Section 2.6.1.3: Word 2010 and later treat the content as a tracked deletion.

<42> Section 2.6.1.4: Word 2010 and later treat the parent as a tracked deletion.

<43> Section 2.6.1.5: Word 2010 and later treat the parent as a tracked insertion.

<44> Section 2.6.1.6: Word 2010 and later treat the content as a tracked insertion.

<45> Section 2.6.1.8: Word 2010 and later ignore this element.

<46> Section 2.6.1.9: Word 2010 and later ignore this element.

    111 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

<47> Section 2.6.1.10: Word 2010 and later ignore this element.

<48> Section 2.6.1.11: Word 2010 and later ignore this element.

<49> Section 2.6.3.1: Word 2010 and later limit this to max 2147483646.

<50> Section 2.6.3.1: Word 2010 and later limit this to max 2147483646.

<51> Section 2.6.3.2: Word 2010 and later write orthographicFront for this attribute and ignore the value when reading.

<52> Section 2.6.3.6: Word 2010 and later limit this to max 2147483646.

<53> Section 2.6.3.23: Word 2010 and later limit this to max 2147483646.

<54> Section 2.6.3.23: Word 2010 and later limit this to max 2147483646.

<55> Section 2.6.3.24: Word 2010 and later limit this to max 2147483646.

<56> Section 2.6.3.24: Word 2010 and later limit this to max 2147483646.

<57> Section 2.6.3.30: Word 2010 and later limit this to max 2147483646.

<58> Section 2.6.3.30: Word 2010 and later limit this to max 2147483646.

<59> Section 2.8.1.1: This element is not available in Word 2010 and earlier.

<60> Section 2.8.3.1: This type is not available in Word 2013 and earlier.

<61> Section 2.8.3.2: This type is not available in Word 2013 and earlier.

<62> Section 2.10.3.1: When intelligentPlaceholder is true, the Office 365 version of Word ignores the content of the comment. Other versions of Word treat the comment as a regular comment.

    112 / 118
[MS-DOCX] - v20251113
Word Extensions to the Office Open XML (.docx) File Format
Copyright © 2025 Microsoft Corporation
Release: November 13, 2025

7 Change Tracking

This section identifies changes that were made to this document since the last release. Changes are classified as Major, Minor, or None.

The revision class Major means that the technical content in the document was significantly revised. Major changes affect protocol interoperability or implementation. Examples of major changes are:

A document revision that incorporates changes to interoperability requirements. A document revision that captures changes to protocol functionality.

The revision class Minor means that the meaning of the technical content was clarified. Minor changes do not affect protocol interoperability or implementation. Examples of minor changes are updates to clarify ambiguity at the sentence, paragraph, or table level.

The revision class None means that no new technical changes were introduced. Minor editorial and formatting changes may have been made, but the relevant technical content is identical to the last released version.

The changes made to this document are listed in the following table. For more information, please contact [email protected].

Section Description Revision class

2.3.9 usePre2018iOSMacLayout Updated section title and contents. Minor

                                                         113 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

8 Index A CT_PresenceInfo 35 CT_PresetLineDashProperties 58 anchorId attribute 47 CT_Props3D 58 appearance element 28 CT_Reflection 59 Applicability 13 CT_RelativeRect 60 Attributes CT_Scene3D 61 anchorId 47 CT_SchemeColor 62 noSpellErr 47 CT_SdtAppearance 36 paraId 47 CT_SdtCheckbox 63 textId 48 CT_SdtCheckboxSymbol 63 CT_SdtRepeatedSection 37 C CT_Shadow 64 CT_SolidColorFillProperties 65 Calendar type extensions 15 CT_SphereCoords 65 Change tracking 113 CT_SRgbColor 66 chartTrackingRefBased element 28 CT_StyleSet 67 checkbox element 38 CT_StylisticSets 67 cntxtAlts element 39 CT_TextOutlineEffect 68 collapsed element 29 conflict extensions 15 color element 29 conflictDel element (CT_RunTrackChange) 39 commentsEx element 29 conflictDel element (CT_TrackChange) 39 commentsExtended part 14 conflictIns element (CT_RunTrackChange) 40 commentsExtensible element (section 2.2.13 16, conflictIns element (CT_TrackChange) 39 section 2.10.1.1 90) conflictMode element 40 commentsExtensible part 14 Connections commentsIds element 87 extensions by part 16 commentsIds part 14 CT_Bevel complex type 48 compatibilityMode element 18 CT_Camera complex type 49 compatSetting elements 16 CT_Color complex type 49 Complex types CT_CommentEx complex type 33 CT_Bevel 48 CT_CommentExtensible complex type 90 CT_Camera 49 CT_CommentId complex type 88 CT_Color 49 CT_CommentsEx complex type 34 CT_CommentEx 33 CT_CommentsExtensible complex type 91 CT_CommentExtensible 90 CT_CommentsIds complex type 88 CT_CommentId 88 CT_DefaultImageDpi complex type 50 CT_CommentsEx 34 CT_Extension complex type 89 CT_CommentsExtensible 91 CT_ExtensionList complex type 89 CT_CommentsIds 88 CT_FillTextEffect complex type 50 CT_DefaultImageDpi 50 CT_Glow complex type 51 CT_Extension 89 CT_GradientFillProperties complex type 51 CT_ExtensionList 89 CT_GradientStop complex type 52 CT_FillTextEffect 50 CT_GradientStopList complex type 52 CT_Glow 51 CT_Ligatures complex type 53 CT_GradientFillProperties 51 CT_LightRig complex type 53 CT_GradientStop 52 CT_LinearShadeProperties complex type 54 CT_GradientStopList 52 CT_LineJoinMiterProperties complex type 54 CT_Ligatures 53 CT_LongHexNumber complex type 55 CT_LightRig 53 CT_NumForm complex type 55 CT_LinearShadeProperties 54 CT_NumSpacing complex type 55 CT_LineJoinMiterProperties 54 CT_OnOff complex type 56 CT_LongHexNumber 55 CT_PathShadeProperties complex type 56 CT_NumForm 55 CT_People complex type 34 CT_NumSpacing 55 CT_Percentage complex type 57 CT_OnOff 56 CT_Person complex type 35 CT_PathShadeProperties 56 CT_PositiveFixedPercentage complex type 57 CT_People 34 CT_PositivePercentage complex type 58 CT_Percentage 57 CT_PresenceInfo complex type 35 CT_Person 35 CT_PresetLineDashProperties complex type 58 CT_PositiveFixedPercentage 57 CT_Props3D complex type 58 CT_PositivePercentage 58 CT_Reflection complex type 59 CT_RelativeRect complex type 60

                                                           114 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

CT_Scene3D complex type 61 CT_LinearShadeProperties 54 CT_SchemeColor complex type 62 CT_LineJoinMiterProperties 54 CT_SdtAppearance complex type 36 CT_LongHexNumber 55 CT_SdtCheckbox complex type 63 CT_NumForm 55 CT_SdtCheckboxSymbol complex type 63 CT_NumSpacing 55 CT_SdtRepeatedSection complex type 37 CT_OnOff 56 CT_Shadow complex type 64 CT_PathShadeProperties 56 CT_SolidColorFillProperties complex type 65 CT_People 34 CT_SphereCoords complex type 65 CT_Percentage 57 CT_SRgbColor complex type 66 CT_Person 35 CT_StyleSet complex type 67 CT_PositiveFixedPercentage 57 CT_StylisticSets complex type 67 CT_PositivePercentage 58 CT_TextOutlineEffect complex type 68 CT_PresenceInfo 35 customXmlConflictDelRangeEnd element 40 CT_PresetLineDashProperties 58 customXmlConflictDelRangeStart element 41 CT_Props3D 58 customXmlConflictInsRangeEnd element 41 CT_Reflection 59 customXmlConflictInsRangeStart element 41 CT_RelativeRect 60 CT_Scene3D 61 D CT_SchemeColor 62 CT_SdtAppearance 36 dataBinding element 30 CT_SdtCheckbox 63 defaultImageDpi element 41 CT_SdtCheckboxSymbol 63 Details CT_SdtRepeatedSection 37 anchorId attribute 47 CT_Shadow 64 appearance element 28 CT_SolidColorFillProperties 65 calendar type extensions 15 CT_SphereCoords 65 chartTrackingRefBased element 28 CT_SRgbColor 66 checkbox element 38 CT_StyleSet 67 cntxtAlts element 39 CT_StylisticSets 67 collapsed element 29 CT_TextOutlineEffect 68 color element 29 customXmlConflictDelRangeEnd element 40 commentsEx element 29 customXmlConflictDelRangeStart element 41 commentsExtended part 14 customXmlConflictInsRangeEnd element 41 commentsExtensible element (section 2.2.13 16, customXmlConflictInsRangeStart element 41 section 2.10.1.1 90) dataBinding element 30 commentsExtensible part 14 defaultImageDpi element 41 commentsIds element 87 differentiateMultirowTableHeaders (section 2.3.4 commentsIds part 14 18, section 2.3.6 19) compatibilityMode 18 discardImageEditingData element 42 compatSetting elements 16 docId element (CT_Guid) 30 conflict extensions 15 docID element (CT_LongHexNumber) 42 conflictDel element (CT_RunTrackChange) 39 doNotFlipMirrorIndents 17 conflictDel element (CT_TrackChange) 39 enableOpenTypeFeatures 17 conflictIns element (CT_RunTrackChange) 40 entityPicker element 42 conflictIns element (CT_TrackChange) 39 glow element 44 conflictMode element 40 ligatures element 44 CT_Bevel 48 noSpellErr attribute 47 CT_Camera 49 numbering definition extensions 16 CT_Color 49 numFmt extensions 21 CT_CommentEx 33 numForm element 44 CT_CommentExtensible 90 numSpacing element 45 CT_CommentId 88 object extensions 15 CT_CommentsEx 34 overrideTableStyleFontSizeAndJustification (section CT_CommentsExtensible 91 2.3.1 17, section 2.3.2 17) CT_CommentsIds 88 p extensions 15 CT_DefaultImageDpi 50 paraId attribute 47 CT_Extension 89 people element 31 CT_ExtensionList 89 people part 14 CT_FillTextEffect 50 pict extensions 15 CT_Glow 51 pPr extensions 16 CT_GradientFillProperties 51 props3d element 45 CT_GradientStop 52 r extensions 16 CT_GradientStopList 52 reflection element 45 CT_Ligatures 53 repeatingSection element 31 CT_LightRig 53 repeatingSectionItem element 31

    115 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

 rPr extensions 14                                     docId (CT_Guid) 30
 scene3d element 45                                    docID (CT_LongHexNumber) 42
 sdtPr extensions 15                                   doNotFlipMirrorIndents 17
 sectPr extensions 16                                  enableOpenTypeFeatures 17
 Settings extensions 14                                entityPicker 42
 shadow element 46                                     glow 44
 ST_BevelPresetType 69                                 ligatures 44
 ST_CompoundLine 70                                    numForm 44
 ST_Ligatures 70                                       numSpacing 45
 ST_LightRigDirection 72                               overrideTableStyleFontSizeAndJustification (section
 ST_LightRigType 73                                    2.3.1 17, section 2.3.2 17)
 ST_LineCap 74                                         people 31
 ST_NumForm 75                                         props3d 45
 ST_NumSpacing 76                                      reflection 45
 ST_OnOff 76                                           repeatingSection 31
 ST_PathShadeType 77                                   repeatingSectionItem 31
 ST_PenAlignment 77                                    scene3d 45
 ST_PresetCameraType 78                                shadow 46
 ST_PresetLineDashVal 81                               stylisticSets 46
 ST_PresetMaterialType 82                              textFill 46
 ST_RectAlignment 83                                   textOutline 47
 ST_SchemeColorVal 84                                  webExtensionCreated 32
 ST_SdtAppearance 38                                   webExtensionLinked 32
 stylesWithEffects part 14                            enableOpenTypeFeatures element 17
 stylisticSets element 46                             entityPicker element 42
 textFill element 46                                  Examples
 textId attribute 48                                   Glowing Text 94
 textOutline element 47                                Stylistic Sets 94
 tr extensions 15                                     Extensions
 webExtensionCreated element 32                        del element 15
 webExtensionLinked element 32                         ins element 15

differentiateMultirowTableHeaders element (section numFmt element 21 2.3.4 18, section 2.3.6 19) object element 15 discardImageEditingData element 42 p element 15 docId element (CT_Guid) 30 pict element 15 docID element (CT_LongHexNumber) 42 pPr element 16 doNotFlipMirrorIndents element 17 r element 16 restartNumberingAfterBreak attribute 16 E rPr element 14 sdtPr element 15 Elements sectPr element 16 appearance 28 Settings element 14 chartTrackingRefBased 28 tr element 15 checkbox 38 Extensions by part cntxtAlts 39 connections 16 collapsed 29 color 29 F commentsEx 29 commentsExtensible (section 2.2.13 16, section Fields - vendor-extensible 13 2.10.1.1 90) Full XML schema 97 commentsIds 87 compatibilityMode 18 G conflictDel (section 2.6.1.3 39, section 2.6.1.4 39) conflictIns (CT_RunTrackChange) 40 Glossary 10 conflictIns (CT_TrackChange) 39 glow element 44 conflictMode 40 Glowing Text example 94 customXmlConflictDelRangeEnd 40 customXmlConflictDelRangeStart 41 I customXmlConflictInsRangeEnd 41 customXmlConflictInsRangeStart 41 Implementer - security considerations 96 dataBinding 30 Informative references 11 defaultImageDpi 41 Introduction 10 differentiateMultirowTableHeaders (section 2.3.4 18, section 2.3.6 19) L discardImageEditingData 42

                                                           116 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

ligatures element 44 ST_PresetCameraType 78 Localization 13 ST_PresetLineDashVal 81 ST_PresetMaterialType 82 N ST_RectAlignment 83 ST_SchemeColorVal 84 Normative references 11 ST_SdtAppearance 38 noSpellErr attribute 47 ST_BevelPresetType simple type 69 Numbering definition extensions 16 ST_CompoundLine simple type 70 numFmt extensions 21 ST_Ligatures simple type 70 numForm element 44 ST_LightRigDirection simple type 72 numSpacing element 45 ST_LightRigType simple type 73 ST_LineCap simple type 74 O ST_NumForm simple type 75 ST_NumSpacing simple type 76 object extensions 15 ST_OnOff simple type 76 overrideTableStyleFontSizeAndJustification element ST_PathShadeType simple type 77 (section 2.3.1 17, section 2.3.2 17) ST_PenAlignment simple type 77 Overview (synopsis) 12 ST_PresetCameraType simple type 78 ST_PresetLineDashVal simple type 81 P ST_PresetMaterialType simple type 82 ST_RectAlignment simple type 83 p extensions 15 ST_SchemeColorVal simple type 84 paraId attribute 47 ST_SdtAppearance simple type 38 people element 31 Structures people part 14 anchorId attribute 47 pict extensions 15 appearance element 28 pPr extensions 16 calendar type extensions 15 Product behavior 110 chartTrackingRefBased element 28 props3d element 45 checkbox element 38 cntxtAlts element 39 R collapsed element 29 color element 29 r extensions 16 commentsEx element 29 References 10 commentsExtended 14 informative 11 commentsExtensible 14 normative 11 commentsExtensible element (section 2.2.13 16, reflection element 45 section 2.10.1.1 90) Relationship to protocols and other structures 12 commentsIds 14 repeatingSection element 31 commentsIds element 87 repeatingSectionItem element 31 compatibilityMode element 18 rPr extensions 14 compatSetting elements 16 conflict extensions 15 S conflictDel element (CT_RunTrackChange) 39 conflictDel element (CT_TrackChange) 39 scene3d element 45 conflictIns element (CT_RunTrackChange) 40 sdtPr extensions 15 conflictIns element (CT_TrackChange) 39 sectPr extensions 16 conflictMode element 40 Security CT_Bevel complex type 48 implementer considerations 96 CT_Camera complex type 49 index of security fields 96 CT_Color complex type 49 Settings extensions 14 CT_CommentEx complex type 33 shadow element 46 CT_CommentExtensible complex type 90 Simple types CT_CommentId complex type 88 ST_BevelPresetType 69 CT_CommentsEx complex type 34 ST_CompoundLine 70 CT_CommentsExtensible complex type 91 ST_Ligatures 70 CT_CommentsIds complex type 88 ST_LightRigDirection 72 CT_DefaultImageDpi complex type 50 ST_LightRigType 73 CT_Extension complex type 89 ST_LineCap 74 CT_ExtensionList complex type 89 ST_NumForm 75 CT_FillTextEffect complex type 50 ST_NumSpacing 76 CT_Glow complex type 51 ST_OnOff 76 CT_GradientFillProperties complex type 51 ST_PathShadeType 77 CT_GradientStop complex type 52 ST_PenAlignment 77 CT_GradientStopList complex type 52 CT_Ligatures complex type 53

                                                           117 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

CT_LightRig complex type 53 repeatingSectionItem element 31 CT_LinearShadeProperties complex type 54 rPr extensions 14 CT_LineJoinMiterProperties complex type 54 scene3d element 45 CT_LongHexNumber complex type 55 sdtPr extensions 15 CT_NumForm complex type 55 sectPr extensions 16 CT_NumSpacing complex type 55 Settings extensions 14 CT_OnOff complex type 56 shadow element 46 CT_PathShadeProperties complex type 56 ST_BevelPresetType simple type 69 CT_People complex type 34 ST_CompoundLine simple type 70 CT_Percentage complex type 57 ST_Ligatures simple type 70 CT_Person complex type 35 ST_LightRigDirection simple type 72 CT_PositiveFixedPercentage complex type 57 ST_LightRigType simple type 73 CT_PositivePercentage complex type 58 ST_LineCap simple type 74 CT_PresenceInfo complex type 35 ST_NumForm simple type 75 CT_PresetLineDashProperties complex type 58 ST_NumSpacing simple type 76 CT_Props3D complex type 58 ST_OnOff simple type 76 CT_Reflection complex type 59 ST_PathShadeType simple type 77 CT_RelativeRect complex type 60 ST_PenAlignment simple type 77 CT_Scene3D complex type 61 ST_PresetCameraType simple type 78 CT_SchemeColor complex type 62 ST_PresetLineDashVal simple type 81 CT_SdtAppearance complex type 36 ST_PresetMaterialType simple type 82 CT_SdtCheckbox complex type 63 ST_RectAlignment simple type 83 CT_SdtCheckboxSymbol complex type 63 ST_SchemeColorVal simple type 84 CT_SdtRepeatedSection complex type 37 ST_SdtAppearance simple type 38 CT_Shadow complex type 64 stylesWithEffects 14 CT_SolidColorFillProperties complex type 65 stylisticSets element 46 CT_SphereCoords complex type 65 textFill element 46 CT_SRgbColor complex type 66 textId attribute 48 CT_StyleSet complex type 67 textOutline element 47 CT_StylisticSets complex type 67 tr extensions 15 CT_TextOutlineEffect complex type 68 webExtensionCreated element 32 customXmlConflictDelRangeEnd element 40 webExtensionLinked element 32 customXmlConflictDelRangeStart element 41 stylesWithEffects part 14 customXmlConflictInsRangeEnd element 41 Stylistic Sets example 94 customXmlConflictInsRangeStart element 41 stylisticSets element 46 dataBinding element 30 defaultImageDpi element 41 T differentiateMultirowTableHeaders element (section 2.3.4 18, section 2.3.6 19) textFill element 46 discardImageEditingData element 42 textId attribute 48 docId element (CT_Guid) 30 textOutline element 47 docID element (CT_LongHexNumber) 42 tr extensions 15 doNotFlipMirrorIndents element 17 Tracking changes 113 enableOpenTypeFeatures element 17 entityPicker element 42 V glow element 44 ligatures element 44 Vendor-extensible fields 13 noSpellErr attribute 47 Versioning 13 numbering definition extensions 16 numFmt extensions 21 W numForm element 44 numSpacing element 45 webExtensionCreated element 32 object extensions 15 webExtensionLinked element 32 overrideTableStyleFontSizeAndJustification element (section 2.3.1 17, section 2.3.2 17) X p extensions 15 paraId attribute 47 XML schema 97 people 14 people element 31 pict extensions 15 pPr extensions 16 props3d element 45 r extensions 16 reflection element 45 repeatingSection element 31

                                                           118 / 118

[MS-DOCX] - v20251113 Word Extensions to the Office Open XML (.docx) File Format Copyright © 2025 Microsoft Corporation Release: November 13, 2025

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment