# Custom XML operations

> Custom XML Data Storage Part operations (ECMA-376 §15.2.5, §15.2.6). Raw read and write of custom XML parts in the OOXML package.



5 operations. Names, descriptions, and behavior flags come from the canonical contract.

## Operations

- [`customXml.parts.list`](/document-api/reference/custom-xml/parts/list) (read): List Custom XML Data Storage Parts in the document, optionally filtered by root namespace or schema reference.
- [`customXml.parts.get`](/document-api/reference/custom-xml/parts/get) (read): Get a single Custom XML Data Storage Part by itemID or package part name, including its full content. v1 partName targeting is limited to Word-style customXml/itemN.xml paths.
- [`customXml.parts.create`](/document-api/reference/custom-xml/parts/create) (mutates): Add a new Custom XML Data Storage Part to the document. Generates a fresh itemID GUID and emits the Properties Part.
- [`customXml.parts.patch`](/document-api/reference/custom-xml/parts/patch) (mutates): Replace the content and/or schemaRefs of an existing Custom XML Data Storage Part. At least one of content or schemaRefs is required. v1 partName targeting is limited to Word-style customXml/itemN.xml paths.
- [`customXml.parts.remove`](/document-api/reference/custom-xml/parts/remove) (mutates): Remove a Custom XML Data Storage Part and clean up all linked package files (item, props, rels, content-types entry). v1 partName targeting is limited to Word-style customXml/itemN.xml paths.