Engagement letter templates are built by your firm's engagement admins, not by the people sending letters day to day. Locking is how those two roles coexist. An admin decides which parts of a letter are firm policy and which parts a preparer can adapt to the client in front of them.
Blocks, variants and flattening
The letter template is assembled from reusable blocks and snippets.
- A block can carry several variants, each with an expression that tests the engagement's data: client type, project name or type, service line, price, custom fields and so on. Aiwyn shows the variant whose condition is met and hides the rest. The preparer does not pick the variant; the data does.
- A block can contain other blocks, snippets and variants. A snippet can contain variants but not another snippet, and a block cannot sit inside a snippet.
- Flatten is the preparer's equivalent of overriding section content. Select the block and choose Flatten: its current wording becomes flat text on this letter only, placeholders inside it keep merging, its variants no longer apply to this letter, and the template is untouched. A user with the Edit Customized Document permission can flatten any block, even if the block is locked.
- Edit on a block is the template-level action. It changes the block everywhere it is used, and the editor warns how many engagements share it. Only users with template permissions see it; for everyone else the button is absent.
- Locking a block does not prevent a user with Edit Customized Document from flattening it. To prevent a user from editing a letter—including flattening content within a locked or unlocked block—remove the Edit Customized Document permission.
- The Highlight dynamic content toggle in the letter editor shows which blocks are dynamic (thick blue left border and a dynamic icon) and which text is a merged placeholder, so a preparer can tell at a glance what is decided by data and what is flat text they can change.
- Renewals are generated from the template again, so flattened or overridden wording on last year's letter does not carry into this year's.
Related
- Edit an unlocked section of a letter
- Permissions required per engagement action