# Merge Word Documents and Generate Letters

Combine complete DOCX files or fill Word merge fields from PowerShell data for packs, letters, and repeatable document batches.

Word has two distinct merge workflows. Document merge appends complete files into a pack. Mail merge replaces named fields with values for one or many recipients.

## Combine complete documents

```powershell
Merge-OfficeDocument `
    -Path '.\Cover.docx','.\Report.docx','.\Appendix.docx' `
    -OutputPath '.\Delivery-Pack.docx'
```

The [merge-documents recipe](https://github.com/EvotecIT/OfficeIMO/blob/3b680b1b6fb15a268ff5525a4ca6cdd70b2f6613/PowerShell/PSWriteOffice/Examples/Word/Recipe-Word-MergeDocuments.ps1) creates a cover, detail document, and appendix, then combines them in order.

## Fill merge fields

Add `MergeField` fields while authoring a template, then call `Invoke-OfficeWordMailMerge -InputObject` with a hashtable. For a batch, create or copy one output per record so each file remains independently reviewable.

```powershell
WordParagraph {
    WordText 'Hello '
    WordField -Type MergeField -Parameters '"FirstName"'
}
Invoke-OfficeWordMailMerge -InputObject @{ FirstName = 'Ada' }
```

The [mail-merge letters recipe](https://github.com/EvotecIT/OfficeIMO/blob/3b680b1b6fb15a268ff5525a4ca6cdd70b2f6613/PowerShell/PSWriteOffice/Examples/Word/Recipe-Word-MailMergeLetters.ps1) generates two personalized order confirmations from ordinary PowerShell hashtables.

## Which merge should you use?

Use document merge when the input files are already complete deliverables. Use mail merge when one layout is repeated over data. Use both when a generated letter must be appended to a standard terms document or evidence pack.

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

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