Letter Builder setup
Configure Letter Builder by enabling the feature, assigning user permissions, managing merge fields, structure, and headers and footers, and creating or editing paragraph content and templates.
Letter Builder lets firms save and store commonly used documents that users can send through Signatures. This article explains how to configure Letter Builder settings, user permissions, merge fields, structure, headers and footers, paragraph content, and templates.
note
This feature is available for customers in the SafeSend Premium Tier.
Turn on and grant user permissions
Before users can access Letter Builder, the feature must be enabled in
My Company
settings and users must be assigned the permissions.Activate Letter Builder
To make Letter Builder available to users with the permissions, turn it on in
My Company
settings.note
Only System Administrators have access to the
Account Management
section.- Select theNavigation Widget.
- SelectAccount Management.
- SelectMy Company.
- LocateCompany Account Details.
- SelectLetter Builder.
Grant user permissions
note
- A System Admin must grant users access to Letter Builder in the SafeSendUser Managementdashboard.
- Refer toUser Group Definitionsfor more information about the default user groups available for Letter Builder. If you don’t want to use a default group, you can create a custom group.
- For bulk updates, useUser Managementto bulk import or edit users.
- Select theNavigation Widget.
- SelectAccount Management.
- SelectUser Management.
- SelectEditnext to the user.
- Select a group withLetter Builderpermissions.
- Users with Admin permissions can deliver templates to clients, but can't edit them.
- Users with Compliance permissions can edit templates and deliver them to clients.
- SelectUpdateto save your changes.
Merge fields
Merge fields let you view and add dynamic placeholders that can be applied to each template.
note
Only System Administrators and Letter Builder - Compliance users have access to the
Settings
section.Manage merge fields
- SelectSettingsin the left panel.
- SelectMerge Fields.
- Use theSearchfield to locate a specific merge field.
- Select a merge field to view its details.
Add merge fields
note
Custom merge fields can't be edited after they are created. They can only be deleted.
- SelectAdd Field.
- Enter aName.
- Enter aDescriptionif needed.
- SelectSave.
Structure Manager
The Structure Manager controls the order in which items appear when using the
Make a Custom Letter
feature. You can also edit item descriptions and associated tags.note
Only System Administrators and Letter Builder - Compliance users have access to the
Settings
section.Navigate Structure Manager
- SelectSettingsin the left panel.
- SelectStructure Manager.
- UseSearchto locate existing sections and categories.
- Select theArrowto expand a section.
- Select aSectionorCategoryto view details.
- Drag and drop items to reorder how they appear when creating a custom letter.
- Select theTrash Canicon to delete a section.
Add a section or category
- SelectAdd.
- SelectSectionorCategory.
- If you selectCategory, note that categories can only be added to theScope of Servicesection.
- Enter aName.
- AddTags.
- Tags are used to identify and apply sections or categories when usingMake a Custom Letter.
- Add aDescription.
- SelectSave.
Edit a section
- Select thePencilicon next to a section.
- Edit theName.
- Edit theDescription.
- Edit theTags.
- Tags are used to identify and apply sections or categories when usingMake a Custom Letter.
- SelectUpdateto save your changes.
Headers and footers
Headers and footers are stored in a central library, so you can reuse the same header or footer across templates and letters.
- Open theHeaders and Footerslibrary.
- Create a new header or footer, or select an existing one.
- Apply it to a template or an individual letter.
Paragraphs
The Paragraphs feature lets you save reusable text sections for different letter types. Paragraph content appears when users select associated tags in the
Make a Custom Letter
feature.Paragraph content can be added through the following steps or while creating templates.
note
Paragraph content must be created before the
Make a Custom Letter
feature can be used.Only System Administrators and Letter Builder - Compliance users can create paragraph content.
Create paragraph content from a file
Refer to
Edit Template
later in this topic for a full overview of editing options.- SelectCreate New.
- SelectCreate your Library.
- SelectNext.
- SelectBuild your Library.
- Upload a.docxfile containing the text you want to use.
- SelectNext.
- Select the text you want to use to create a paragraph.
- Select aSection.
- Select aTag.
- SelectSave.
- Select thePlusicon to add and save more paragraphs. This option is available only after you selectSave.
- Select theFieldstab to add signature blocks.
- Place your cursor where you want the field, then select the field option.
- Refer toEdit Templatelater in this topic for more editing options.
- Select the sections and select the plus icon to save them as paragraph sections.
- SelectFinishto save the paragraph content.
Edit paragraph content
- Go toContent Libraryin the left panel.
- SelectParagraph.
- Select theSectionto edit.
- Select 1 or more templates to delete if needed.
- SelectEditto update the paragraph.
- SelectDeleteto remove the template.
- Select theMoremenu to view additional options.
- SelectUser Trackingto review an audit of changes made to the paragraph template.
- SelectUnlockto release the template for editing.
- A template assigned to another user is locked and can't be edited until it is unlocked.
Save a template
Use this option to upload an existing
.docx
template, then edit and save it for future use. Refer to Edit Template
later in this topic for a full overview of editing options.note
Only System Administrators and Letter Builder - Compliance users can create templates.
- SelectCreate New.
- SelectCreate your Library.
- SelectNext.
- SelectSave your Template.
- Enter aTemplate Name.
- Enter aDescription.
- SelectNext.
- Upload a.docxtemplate file.
- SelectNext.
- Edit the template as described inEdit Template.
- SelectPublishto save the template and let users with the permissions to send it.
- SelectSave as Draftto save the template in the Content Library with Draft status.
- SelectSend for Reviewto save the template in the Content Library with In Review status.
Create a new template
Use this option to build a template from scratch. Refer to
Edit Template
later in this topic for a full overview of editing options.note
Only System Administrators and Letter Builder - Compliance users can create templates.
- SelectCreate New.
- SelectCreate your Library.
- SelectNext.
- SelectCreate New.
- Enter aTemplate Name.
- Enter aDescription.
- SelectNext.
- Edit the template as described inEdit Template.
- SelectPublishto save the template and let users with permissions to send it.
- SelectSave as Draftto save the template in the Content Library with Draft status.
- SelectSend for Reviewto save the template in the Content Library with In Review status.
Stored templates
The Templates section of the Content Library contains saved templates. You can edit, remove, and review templates in this area.
note
Only System Administrators and Letter Builder - Compliance users have access to the Content Library.
- Go toContent Libraryin the left panel.
- SelectTemplates.
- Use theSearchbar to locate template names.
- Select theTrash Canicon to delete selected templates.
- SelectRefreshto update changes made to the report.
- SelectEditto open the template for editing.
- SelectDeleteto remove the template.
- Select theMoremenu to view additional options.
- SelectDescriptionto view or edit the description.
- SelectUser Trackingto review an audit of edits made to the template.
- SelectUnlockto release the template for editing.
- A template assigned to another user is locked and can't be edited until it is unlocked.
Edit template
After a Letter Builder template is created, you can edit it before publishing. The editor includes tools for formatting content, inserting merge fields, and placing signer fields.
note
Only System Administrators and Letter Builder - Compliance users can edit templates.
Editing tools
- Insert anImage,Table, orLink.
- Place the cursor on the page and selectPage Numberto add page numbers in sequence.
- Place the cursor on the page and selectBreakto select the type of page break to add.
- SelectInsert FootnoteorInsert Endnoteto insert notes.
- SelectFindto search for keywords in the letter.
- SelectVersion Historyto view past versions of the template.
- SelectCompare Versionsto view the previous version alongside the current version, with the differences highlighted.
- Revert to the latest version if needed.
note- Compare Versions is available for both templates and paragraphs.
- FromVersion History, you can restore or make a copy.
- FromParagraphs, you can restore but you can't make a copy.
- Use theTextcolumn to customize content.
Merge fields in templates
Merge fields act as placeholders for client data. How they're filled depends on how the letter is delivered:
- Bulk: Values come from the CSV file that's created when the letter is sent to Signatures.
- Individual: Values are entered in theFill Detailstab before the letter is sent. Refer toSend an individual letterin Letter Builder Usage.
- Place the cursor where the merge field should appear.
- SelectInsert Merge Field.
- Select themergefield to insert.noteYou can useSearchto find a listed merge field.
Signer fields
Signer fields are managed in the
Signature Fields
panel. There's no limit to the number of signers you can add to a template, paragraph, or letter.Refer to
Additional Signature Controls
for more information about applying rules to checkbox and radio button controls.note
Conditional controls are temporarily not available for Individual letter delivery because they don't currently transfer over correctly to Signatures or the taxpayer view. If you add one, you're asked to remove it. You can still add conditional controls in Signatures. A permanent fix is planned for an upcoming release.
- Open theSignature Fieldspanel.
- Select+ Add signerto add a signer if needed.
- The 1st 5 signers can't be removed. Signers added after them can be.
- Select theRecipientfrom the dropdown list.
- Signer fields are color-coded by the recipient.
- Place the cursor where the field should be inserted.
- SelectSignatureto place the designated signature field.
- Select theRequiredcheckbox if the signature must be completed.
- Signature fields are not required by default.
- Select theUndoicon to reverse the last action.