# @univerjs-pro/docs-sdt

> Language fallback: requested `zh-CN`; content is `en-US`.

- Human documentation: [https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/docs-sdt](https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/docs-sdt)

- Agent Markdown: [https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/docs-sdt.md](https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/docs-sdt.md)

- Requested language: `zh-CN`

- Content language: `en-US`

- Documentation version: `1.0.0`

- Source: [packages/plugins/univerjs-pro/docs-sdt.mdx](https://github.com/dream-num/documentation/blob/dev/content/reference/packages/plugins/univerjs-pro/docs-sdt.mdx)

---

Structured document tag (SDT) commands for Docs content controls. Register the Docs core and license plugins first, then add this plugin and the optional [`@univerjs-pro/docs-sdt-ui`](https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/docs-sdt-ui.md) editor controls.

```ts
import { UniverDocsSdtPlugin } from '@univerjs-pro/docs-sdt'

univer.registerPlugin(UniverDocsSdtPlugin)
```

## Commands and locks

The root exports `UpdateSdtValueCommand`, `UpdateSdtPropertiesCommand`, `RemoveSdtCommand`, `DuplicateRepeatingSdtItemCommand`, `DeleteRepeatingSdtItemCommand`, and their parameter types. Run them through the command service or `univerAPI.executeCommand()` so edits participate in undo/redo.

Content controls live in `IDocumentBody.customRanges`, with their properties in `ISdtCustomRange.properties`. Content locks prevent value edits; control locks prevent removing the wrapper. Repeating sections can also disallow item insertion and deletion. The root exports `isSdtContentLocked`, `isSdtWrapperLocked`, and `findSdtAtOffset` for integrations.

This package has no stylesheet, locales, or Facade entry. DOCX conversion belongs to Exchange; editor support does not guarantee lossless support for every Word property or custom XML binding. See the [content-controls guide](https://docs.univer.ai/zh-CN/guides/docs/features/content-controls.md).