Manage Word templates
Applies to Dynamics 365 for Customer Engagement apps version 9.x
Microsoft Word provides powerful ways to present your Dynamics 365 data in a standardised and well-formatted document. With Word templates, you can easily create and share your template with others, so all the documents that go out to your customers have a consistent look that matches your organisation's branding.
When the templates are ready, users can generate standardised documents that are automatically populated with Dynamics 365 data with just one click.
Step 1: Create a Word template
Sign in to Dynamics 365 as a user with the System Administrator role.
Go to Settings > Advanced Settings > Organisation > Excel & Word Templates and choose New Template.
Select Word Template, and then select Next.
Select an entity to which the template applies. The template will use data from this entity.
To select the fields that you want to be included in the Word template, select Choose Related Entities.
The Choose Related Entity dialogue box opens. The relationships you select on this screen determine what entities and fields are available later when you define the Word template. Only select the relationships you need to add Dynamics 365 data to the Word template. Here are some example relationships for the account entity:
1:N Relationship. An account can have multiple contacts.
N:1 Relationship. A lead, account, or contact can have multiple accounts.
N:N Relationship. An account can have multiple marketing lists. A marketing list can have multiple accounts.
When you're done choosing relationships, select Done.
To ensure that documents are downloaded in a timely matter, there is an upper limit of 100 for the number of related records returned for each relationship. For example, if you're exporting a template for an account and you want to include a list of its contacts, the document will return at most 100 of the account's contacts.
In the Select Entity dialogue box, select Next.
Select Download to create a Word file on your local computer with the exported entity included as XML data.
To upload the template later, select Upload the template later check box, and then select Next.
To upload the template after you customise the data, go to the list of templates, and then select Upload Template. More information: Step 4: Upload the Word template back into Dynamics 365
Step 2: Enable the Developer tab
Open the Word template file. At this point, the document appears to be blank.
To see and add Dynamics 365 XML data, you need to enable the Word Developer tab.
Go to File > Options > Customise Ribbon, and then select the Developer check box.
The Developer tab now appears in the Word ribbon.
Step 3: Define the Word template
Use the XML Mapping Pane to define the Word template by using Dynamics 365 entity fields.
In your Word template, select Developer > XML Mapping Pane.
The XML Mapping pane opens with the default XML schema selected.
Select the Dynamics 365 XML schema. It will begin with "urn:microsoft-crm/document-template/".
If you have frequent accidental edits that cause Word to freeze or degrade its performance, turn off the AutoCorrect options.
Expand the entity to see all available fields, right-click the field you want to add, and then select Insert Content Control > Plain Text.
The field from Dynamics 365 is added to the Word template.
Add additional entity fields, add descriptive labels and text, and format the document. A completed template might look like this:
Some content control fields you entered are likely to have multiple lines of data. For example, accounts have more than one contact. To include all the data in your Word template, set the content control field to repeat as follows:
Put fields with repeating data in a table row.
Select the entire table row in the template.
In the XML Mapping pane, right-click the relationship containing the content control fields, and then select Repeating.
When you use the Word template in Dynamics 365 to create a document, the table will be populated with multiple rows of data.
When the template has the fields and formatting you want, save it and upload it into Dynamics 365.
Step 4: Upload the Word template into Dynamics 365
When you have your Word template built the way you want, save it so you can upload it into Dynamics 365.
An administrator can use the Settings page to upload the Word template into Dynamics 365.
Users in your organisation can see the templates available to them by selecting Word Templates on the command bar in the list of records.
In Dynamics 365, go to Settings > Advanced Settings > Organisation > Excel & Word Templates.
Select Upload Template.
Find and upload the file.
Select Upload. You'll see the summary of the file you're uploading.