# Create and Process PDF Forms and Annotations

Create interactive form fields, inspect and fill existing forms, manage annotations, and flatten only when the delivery policy requires it.

PDF forms are interactive data structures, not just boxes painted on a page. Keep them interactive while recipients must enter or review values, then flatten a delivery copy only when editing must stop.

## Author fields in the PDF DSL

`PdfFormField` supports text, check box, choice, multi-select choice, and radio-button fields inside a generated document. Name every field predictably so later automation can inspect or fill it.

```powershell
PdfFormField -Name Reviewer -Type Text -Value 'Unassigned' -Width 320 -Height 24
PdfFormField -Name Decision -Type Choice -Option Approve,Reject,Defer -Value Defer
```

The [forms recipe](https://github.com/EvotecIT/OfficeIMO/blob/3b680b1b6fb15a268ff5525a4ca6cdd70b2f6613/PowerShell/PSWriteOffice/Examples/Pdf/Recipe-Pdf-Forms.ps1) creates text, choice, and check-box fields in one composition block.

## Fill, inspect, or flatten

Use `Set-OfficePdfFormField` to fill existing fields and `Get-OfficePdfFormField` to read them back. `Update-OfficePdf -FlattenForm` makes field appearances part of page content. For annotations, use `Get-OfficePdfAnnotation`, `Set-OfficePdfAnnotation`, `Remove-OfficePdfAnnotation`, and `Update-OfficePdf -FlattenAnnotation` according to the review lifecycle.

Flattening is a one-way delivery decision for the output copy. Preserve the interactive source when the workflow may need another review round.

<!-- PowerForge markdown source sha256:FDDCD9C9A34C1EED66741CFC9CFD5023C2BD2F9EE67E354C222AF6CA9009A132; title=True -->

<!-- PowerForge markdown artifact sha256:A6686F8A77473B348CAC4B0AE14E1D921B1E10A87E0DFFF1216FDFDA29CCB880 -->
