This article is targeted towards client IT trying to troubleshoot issues regarding the Templafy web add-ins.
Please ensure that all of the following steps have been completed before escalating the issue.
Prerequisites
|
ImportantFor the investigation of all email signature issues, please ensure that a recent Email Signature Synchronization has taken place. |
Confirm requirements are met
Ensure prerequisites for running Templafy Web Add-ins are met.
NoteFor Outlook Web Add-ins, only five event-based add-ins can be actively running. Ensure the use of Templafy does not exceed this limit. |
Reset automatic events (Email Signature Only)
- Open the Templafy Email Signature task pane.
- Click on the three dots ellipsis menu in the top right corner.
- Click on Settings.
- Ensure Disable automatic events is not enabled.
- Click Reset automatic events.
- Close Outlook and reopen to check signature insertion.
Check task pane behavior
Make sure to reproduce the error after enabling the settings / completing the reviews below.
Enable Mail Log Messages (Email Signature Only)
When troubleshooting, enabling mail log messages will output certain events in the console log. Logging is enabled on a per-user basis. To enable the logging, open the Email Signature Task Pane by clicking on the Templafy Email Signature logo. Then, select Settings under the three dots in the top right corner and enable the setting.
NoteMail log messages are only applied to new emails after the setting is enabled, so make sure to close the current email and start a new one before gathering the logs. |
Review Console Logs
NoteThe below steps detail investigation into the Email Signature Web add-in. Reviewing the Console Logs and Network Communication should also be performed if there is an issue with Library Web Add-in, however, expect different requests. |
From the Email Signature task pane, open the DevTools window:
- Classic Outlook / Outlook Online: Press F12 or right-click and select Inspect.
- New Outlook: start Outlook with the following command in command prompt
olk.exe --devtools
Then, select the Console tab at the top to show generic console logs, logs generated by Templafy, and Microsoft Office logs. Look for any errors or warnings that may be causing issues.
Review Network Communication
Within the DevTools window, the Network tab contains many requests made by Microsoft, so filtering on the keyword templafy is suggested. Please look for the specific requests below:
-
runtime_settings
- should return the list of Internal Domains for the customer. If the wrong domains or no domains are listed, make adjustments in Email Signature Settings section of your Templafy tenant.
-
manifest.json
- should return the list of all signatures that were synchronized (can be found underemailSignatureDescriptors
). If nothing is returned, ensure the user has been assigned to a signature and trigger a new synchronization.
If the issue cannot be resolved after the above steps are completed, please share the files gathered with Templafy Support.
Changing the User Profile does not change the signature
In this scenario, open the Email Signature task pane and review the Network communication requests:
-
manifest.json
- should return the list of all signatures that were synchronized (can be found underemailSignatureDescriptors
). -
referencedImages.json
- should return a series of images with base64 content. If some images are not visible in the signature, check the base64 content property. If the base64 cannot be converted to an image using an online tool, check the image in the tenant. -
signature.html
- should return the signature without rendered images. Check for the Preview and verify the signature.
Blank Templafy task pane
If a blank task pane appears, please refer to Step 1: Confirm Requirements are Met to ensure WebView2 was correctly installed/repaired. If that did not solve the issue, please continue with the following:
- In the affected Office application, click File > Options.
- Click Trust Center > Trust Center Settings.
- Click Trusted Add-in Catalogs and enable Next time Office starts, clear all previously-started web add-ins cache.
- Click Ok.
Duplicated signatures
If multiple signatures are being inserted, please ensure the email is in HTML format instead of Plain Text format.
Important
|
Web Add-in is not visible in Office applications
If the Templafy Web Add-in is not automatically available in the ribbon of the desired Office application, follow the steps below:
- Open the desired Office application.
- Select Add-ins followed by More Add-ins from the ribbon.
- On the navigation bar at the top, select Admin Managed.
- Select the desired Templafy Web Add-in and press Add.
- If the Add-in is still not visible, please ensure your Ribbon layout is Classic instead of Single Line.
Comments
Article is closed for comments.