# Images operations

> Image lifecycle, placement, and wrap configuration.



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

## Operations

- [`images.list`](/document-api/reference/images/list) (read): List all images in the document.
- [`images.get`](/document-api/reference/images/get) (read): Get details for a specific image by its stable ID.
- [`images.delete`](/document-api/reference/images/delete) (mutates, tracked): Delete an image from the document.
- [`images.move`](/document-api/reference/images/move) (mutates, tracked): Move an image to a new location in the document. Tracked-mode authoring supports safe sole inline-image body paragraphs and emits paired `<w:moveFrom>` / `<w:moveTo>` wrappers with explicit move range marker identity.
- [`images.convertToInline`](/document-api/reference/images/convert-to-inline) (mutates, tracked): Convert a floating image to inline placement.
- [`images.convertToFloating`](/document-api/reference/images/convert-to-floating) (mutates, tracked): Convert an inline image to floating placement.
- [`images.setSize`](/document-api/reference/images/set-size) (mutates, tracked): Set explicit width/height for an image.
- [`images.setWrapType`](/document-api/reference/images/set-wrap-type) (mutates, tracked): Set the text wrapping type for a floating image.
- [`images.setWrapSide`](/document-api/reference/images/set-wrap-side) (mutates, tracked): Set which side(s) text wraps around a floating image.
- [`images.setWrapDistances`](/document-api/reference/images/set-wrap-distances) (mutates, tracked): Set the text-wrap distance margins for a floating image.
- [`images.setPosition`](/document-api/reference/images/set-position) (mutates, tracked): Set the anchor position for a floating image.
- [`images.setAnchorOptions`](/document-api/reference/images/set-anchor-options) (mutates, tracked): Set anchor behavior options for a floating image.
- [`images.setZOrder`](/document-api/reference/images/set-z-order) (mutates, tracked): Set the z-order (relativeHeight) for a floating image.
- [`images.scale`](/document-api/reference/images/scale) (mutates, tracked): Scale an image by a uniform factor applied to both dimensions.
- [`images.setLockAspectRatio`](/document-api/reference/images/set-lock-aspect-ratio) (mutates, tracked): Lock or unlock the aspect ratio for an image.
- [`images.rotate`](/document-api/reference/images/rotate) (mutates, tracked): Set the absolute rotation angle for an image.
- [`images.flip`](/document-api/reference/images/flip) (mutates, tracked): Set horizontal and/or vertical flip state for an image.
- [`images.crop`](/document-api/reference/images/crop) (mutates, tracked): Apply rectangular edge-percentage crop to an image.
- [`images.resetCrop`](/document-api/reference/images/reset-crop) (mutates, tracked): Remove all cropping from an image.
- [`images.replaceSource`](/document-api/reference/images/replace-source) (mutates, tracked): Replace the image source while preserving identity and placement.
- [`images.setAltText`](/document-api/reference/images/set-alt-text) (mutates, tracked): Set the accessibility description (alt text) for an image.
- [`images.setDecorative`](/document-api/reference/images/set-decorative) (mutates, tracked): Mark or unmark an image as decorative.
- [`images.setName`](/document-api/reference/images/set-name) (mutates, tracked): Set the object name for an image.
- [`images.setHyperlink`](/document-api/reference/images/set-hyperlink) (mutates, tracked): Set or remove the hyperlink attached to an image.
- [`images.insertCaption`](/document-api/reference/images/insert-caption) (mutates): Insert a caption paragraph below the image.
- [`images.updateCaption`](/document-api/reference/images/update-caption) (mutates, tracked): Update the text of an existing caption paragraph.
- [`images.removeCaption`](/document-api/reference/images/remove-caption) (mutates): Remove the caption paragraph from below the image.

