{"versionId":"65b8f028-4685-42bf-8440-08dd98259565","articleId":"fd1306e5-7273-46f5-9a7f-08dd4a203b41","title":"How to create and configure a template document","tags":["Template","All articles"],"content":"<html><head></head><body><p>Automate and standardise the creation of compliant and on-brand documents with templates in Theta Assist. Here's how it works:&nbsp;</p>\n<ol>\n<li>Create an assistant that will be used to create this type of document</li>\n<li>Create a template for this type of document in Word, with placeholders and relevant formatting/branding</li>\n<li>Upload your template&nbsp;</li>\n<li>Add placeholder descriptions in Theta Assist</li>\n<li>Customise the prompt to collect the info needed to populate the template, and instruct the&nbsp;assistant to export to file</li>\n</ol>\n<h2>Click-through demo of template creation</h2>\n<div style=\"max-width: 650px;\" data-ephox-embed-iri=\"https://app.storylane.io/share/bc5rzyttdtto\">\n<div class=\"ephox-summary-card\"><a class=\"ephox-summary-card-link-thumbnail\" href=\"https://app.storylane.io/demo/bc5rzyttdtto\"> <img class=\"ephox-summary-card-thumbnail\" src=\"https://app-pages.storylane.io/company/company_5c409c86-4889-49da-ae9f-832f13087f44/project/project_ac260a30-9fbb-4f00-a122-1c9046555f3b/preview.gif\"> </a> <a class=\"ephox-summary-card-link\" href=\"https://app.storylane.io/demo/bc5rzyttdtto\"> <span class=\"ephox-summary-card-title\">Theta Assist Advanced Feature Tour</span> <span class=\"ephox-summary-card-website\">Storylane</span> </a></div>\n</div>\n<h1>Step-by-step guide</h1>\n<h2>1. Create an assistant</h2>\n<p>Follow the instructions <a href=\"https://help.thetaassist.ai/article/how-to-make-your-own-assistant\" target=\"_blank\" rel=\"noopener\">here</a> to create a new assistant. Give it a name that relates to the kind of document you want to create - eg Status Report Generator</p>\n<h2>2. Create your template</h2>\n<ul>\n<li>Theta Assist supports the use of Word documents (.docx) as templates.</li>\n<li>Your template file can include any required&nbsp;organisation branding and formatting</li>\n<li>Templates should include any desired placeholders - see below</li>\n</ul>\n<h3>Configuring your template with placeholders</h3>\n<p>Placeholders mark locations in your Word document where AI-generated text will appear.&nbsp;</p>\n<h4>Placeholder format</h4>\n<p>Placeholders in your document should be in the format <code>$placeholder</code> - i.e. start with a $, followed by <span data-teams=\"true\">a-z, A-Z, 0-9, no spaces.</span></p>\n<h4>Default placeholders</h4>\n<p>The following placeholders are built into Theta Assist:</p>\n<ul>\n<li><code>$fullname</code>: Inserts the user's full name.</li>\n<li><code>$email</code>: Inputs the user's email address.</li>\n<li><code>$assistantid:</code> Adds the current assistant's unique identifier.</li>\n<li><code>$assistantname</code>: Places the current assistant's display name.</li>\n<li><code>$threadid</code>: Incorporates the current thread's unique identifier.</li>\n<li><code>$threadlink</code>:&nbsp;Inserts the current thread's URL*</li>\n</ul>\n<p><em>*Note the recipient of the document generated will only be able to access the thread if it has been shared with them</em></p>\n<h4>Custom placeholders</h4>\n<p>You can also add your own placeholders to your template, using the format <code>$placeholder</code>, anywhere you would like the Assistant to add text to your document.</p>\n<h2>3. Upload your template</h2>\n<ol>\n<li>Edit the assistant you created in step one</li>\n<li>Navigate to the&nbsp;<strong>Template</strong> tab&nbsp;</li>\n<li>Upload your template</li>\n</ol>\n<p><img src=\"https://portal.helpfruit.com/api/images/0d5220bc9ad14992d05108dccd460f35/files/Create%20new%20template.png?width=1000&amp;height=\"></p>\n<h2>4. Customise placeholders</h2>\n<p>Theta Assist will automatically extract any placeholders included in your document.</p>\n<p>Add a short description for each. This should describe what you want the Assistant to insert here - eg \"Summary\", \"Next steps\"</p>\n<p><img src=\"https://portal.helpfruit.com/api/images/0d5220bc9ad14992d05108dccd460f35/files/Placeholders%20in%20Theta%20Assist.png?width=1000&amp;height=\"></p>\n<h3>Date/time replacement</h3>\n<p>To add the current date/time, start your description with&nbsp;<code>datetime:</code>&nbsp;followed by your desired format string. The placeholder will be replaced with the current date/time—formatted as specified—in the assistant's configured time zone. For example,&nbsp;<code>datetime:MM/dd/yyyy</code>&nbsp;might render as&nbsp;02/19/2025.</p>\n<details class=\"mce-accordion\">\n<summary><strong>View date/time format options</strong></summary>\n<table style=\"width: 712px;\">\n<thead>\n<tr>\n<th style=\"width: 64.390625px;\">Code</th>\n<th style=\"width: 251.84375px;\">Description</th>\n<th style=\"width: 89.484375px;\">Example</th>\n<th style=\"width: 250.1875px;\">Category</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td style=\"width: 64.390625px;\">d</td>\n<td style=\"width: 251.84375px;\">Day (1-31)</td>\n<td style=\"width: 89.484375px;\">5</td>\n<td style=\"width: 250.1875px;\">Date</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">dd</td>\n<td style=\"width: 251.84375px;\">Day with leading zero (01-31)</td>\n<td style=\"width: 89.484375px;\">05</td>\n<td style=\"width: 250.1875px;\">Date</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">ddd</td>\n<td style=\"width: 251.84375px;\">Abbreviated day name</td>\n<td style=\"width: 89.484375px;\">Mon</td>\n<td style=\"width: 250.1875px;\">Date</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">dddd</td>\n<td style=\"width: 251.84375px;\">Full day name</td>\n<td style=\"width: 89.484375px;\">Monday</td>\n<td style=\"width: 250.1875px;\">Date</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">M</td>\n<td style=\"width: 251.84375px;\">Month (1-12)</td>\n<td style=\"width: 89.484375px;\">9</td>\n<td style=\"width: 250.1875px;\">Date</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">MM</td>\n<td style=\"width: 251.84375px;\">Month with leading zero (01-12)</td>\n<td style=\"width: 89.484375px;\">09</td>\n<td style=\"width: 250.1875px;\">Date</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">MMM</td>\n<td style=\"width: 251.84375px;\">Abbreviated month name</td>\n<td style=\"width: 89.484375px;\">Sep</td>\n<td style=\"width: 250.1875px;\">Date</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">MMMM</td>\n<td style=\"width: 251.84375px;\">Full month name</td>\n<td style=\"width: 89.484375px;\">September</td>\n<td style=\"width: 250.1875px;\">Date</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">y</td>\n<td style=\"width: 251.84375px;\">Year as 1-2 digits</td>\n<td style=\"width: 89.484375px;\">23</td>\n<td style=\"width: 250.1875px;\">Date</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">yyyy</td>\n<td style=\"width: 251.84375px;\">Full 4-digit year</td>\n<td style=\"width: 89.484375px;\">2023</td>\n<td style=\"width: 250.1875px;\">Date</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">h</td>\n<td style=\"width: 251.84375px;\">Hour (1-12)</td>\n<td style=\"width: 89.484375px;\">3</td>\n<td style=\"width: 250.1875px;\">Time</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">hh</td>\n<td style=\"width: 251.84375px;\">Hour with leading zero (01-12)</td>\n<td style=\"width: 89.484375px;\">03</td>\n<td style=\"width: 250.1875px;\">Time</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">H</td>\n<td style=\"width: 251.84375px;\">24-hour (0-23)</td>\n<td style=\"width: 89.484375px;\">15</td>\n<td style=\"width: 250.1875px;\">Time</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">HH</td>\n<td style=\"width: 251.84375px;\">24-hour with leading zero (00-23)</td>\n<td style=\"width: 89.484375px;\">15</td>\n<td style=\"width: 250.1875px;\">Time</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">m</td>\n<td style=\"width: 251.84375px;\">Minute (0-59)</td>\n<td style=\"width: 89.484375px;\">9</td>\n<td style=\"width: 250.1875px;\">Time</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">mm</td>\n<td style=\"width: 251.84375px;\">Minute with leading zero (00-59)</td>\n<td style=\"width: 89.484375px;\">09</td>\n<td style=\"width: 250.1875px;\">Time</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">s</td>\n<td style=\"width: 251.84375px;\">Second (0-59)</td>\n<td style=\"width: 89.484375px;\">5</td>\n<td style=\"width: 250.1875px;\">Time</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">ss</td>\n<td style=\"width: 251.84375px;\">Second with leading zero (00-59)</td>\n<td style=\"width: 89.484375px;\">05</td>\n<td style=\"width: 250.1875px;\">Time</td>\n</tr>\n<tr>\n<td style=\"width: 64.390625px;\">tt</td>\n<td style=\"width: 251.84375px;\">AM/PM indicator</td>\n<td style=\"width: 89.484375px;\">PM</td>\n<td style=\"width: 250.1875px;\">Time</td>\n</tr>\n</tbody>\n</table>\n<p>You can combine these format codes using any separators (/ - : etc) to create custom date/time formats.<br><br><strong>Example Formats:</strong></p>\n<ul>\n<li><code>datetime:MM/dd/yyyy</code>&nbsp;→ 01/24/2025</li>\n<li><code>datetime:MMMM d, yyyy</code>&nbsp;→ January 24, 2025</li>\n<li><code>datetime:ddd, MMM d, yyyy h:mm tt</code>&nbsp;→ Fri, Jan 24, 2025 3:30 PM</li>\n<li><code>datetime:HH:mm:ss</code>&nbsp;→ 15:30:00</li>\n</ul>\n</details>\n<h3>Ignore setting</h3>\n<p>If any placeholders should remain as text and not be replaced by AI, check the \"Ignore\" box beside the placeholder. These won't be included in AI-generated text.</p>\n<h3>Completing the configuration</h3>\n<p>After configuring your placeholders and inserting necessary descriptions, click <strong>Save Descriptions</strong>&nbsp;at the bottom of the page to save your changes.</p>\n<h3>Updating your template</h3>\n<p>Missed a placeholder on want to change something? You can replace your existing template with a new one.</p>\n<h3>Active vs Inactive</h3>\n<p><strong>Active Placeholders</strong>: These are currently used in the latest version of your template.</p>\n<p><strong>Inactive Placeholders</strong>: These are previously configured placeholders that no longer exist. Remove them if they are no longer needed.</p>\n<h2>5. Customise your prompt&nbsp;</h2>\n<p>Once your template is set up and configured, adjust the default prompt to collect the information required to populate your template.</p>\n<p><span style=\"background-color: #f1c40f;\">IMPORTANT: </span>You need to include an instruction in your prompt to use the 'save_to_file' function to export the contents of&nbsp;the file.</p>\n<p>For example: \"When complete, you'll save the full report using the&nbsp;save_to_file function.\" or \"When complete, you'll save the output using the save_to_file function.\"</p></body></html>","description":"","isMarkdown":false,"publishedOnUtc":"2025-10-30T01:14:16.3991884","modifiedOnUtc":"2025-02-17T20:37:25.6427056"}