Getting Started with Templify¶
Welcome! This guide will help you create your first Word document template with Templify. No programming experience required - if you can use Microsoft Word and edit a simple text file, you can create templates.
What is Templify?¶
Templify is a tool that takes a Word document template with placeholders (like {{CompanyName}}) and fills them in with your data to create personalized documents. Think of it like mail merge, but more powerful.
What You'll Need¶
- Microsoft Word (or any app that can edit .docx files)
- A text editor (Notepad, TextEdit, VS Code, or any editor for JSON files)
- Templify (either the GUI app or CLI tool)
Your First Template in 5 Minutes¶
Step 1: Create a Word Template¶
- Open Microsoft Word
- Create a new document
- Type some text with placeholders in double curly braces:
Hello {{Name}}!
Welcome to {{CompanyName}}. We're excited to have you on board.
Your account has been created with the email: {{Email}}
- Save the document as
welcome-letter.docx
That's it! You've created your first template. The text inside {{...}} are placeholders that will be replaced with actual data.
Step 2: Prepare Your Data (JSON)¶
Now you need to provide the data to fill in those placeholders. We use a format called JSON (don't worry, it's simple!).
Create a file called data.json with this content:
Understanding the structure:
- The whole thing is wrapped in { } (curly braces)
- Each piece of data is written as "PlaceholderName": "Value"
- Separate each piece with a comma
- Text values need double quotes around them
Step 3: Process Your Template¶
Now you'll combine the template with the data to create the final document.
Option A: Using the GUI Application¶
- Open the Templify GUI application
- Click "Select Template" and choose
welcome-letter.docx - Click "Select Data" and choose
data.json - Click "Process Template"
- Save the output as
welcome-letter-final.docx
Option B: Using the Command Line¶
If you have the CLI tool installed, run:
Step 4: View the Result¶
Open welcome-letter-final.docx in Word. You should see:
Hello Alice Johnson!
Welcome to Acme Corporation. We're excited to have you on board.
Your account has been created with the email: alice.johnson@acme.com
Congratulations! You've created and processed your first template! 🎉
What You Can Do With Templates¶
Simple Placeholders¶
Replace any text with data from your JSON file:
Template:
Data (data.json):
Nested Data¶
Access data within data using dots (.):
Template:
Data (data.json):
Conditional Content¶
Show or hide content based on conditions:
Template:
{{#if IsPremium}}
Thank you for being a Premium member!
{{/if}}
{{#if Status = "Active"}}
Your account is active.
{{#else}}
Your account needs activation.
{{/if}}
Data (data.json):
Repeating Content (Loops)¶
Repeat content for each item in a list:
Template:
Data (data.json):
{
"Items": [
{ "Name": "Widget", "Price": "10.00" },
{ "Name": "Gadget", "Price": "25.00" },
{ "Name": "Doohickey", "Price": "15.00" }
]
}
Result:
Common Mistakes to Avoid¶
❌ Wrong Placeholder Syntax¶
{Name} ← Only one curly brace (needs two)
{{Name} ← Missing closing braces
{{ Name }} ← Spaces inside (remove them)
✅ Correct Placeholder Syntax¶
❌ Invalid JSON¶
{
Name: "Alice" ← Missing quotes around the key
"Email": alice@... ← Missing quotes around the value
"Age": 25, ← Extra comma at the end
}
✅ Valid JSON¶
Tip: Use a JSON validator website (like jsonlint.com) to check your JSON files if you get errors.
Next Steps¶
Now that you've created your first template, explore more advanced features:
- JSON Basics - Learn more about JSON data format
- Placeholders - All the ways to use placeholders
- Conditionals - Show/hide content with if/else
- Loops - Repeat content for lists and tables
- Format Specifiers - Format numbers, dates, and more
- Best Practices - Tips for creating maintainable templates
Need Help?¶
- Can't find your placeholder? Make sure the name in
{{...}}exactly matches the name in your JSON (including uppercase/lowercase) - Getting an error? Check that your JSON is valid using a JSON validator
- Template not changing? Make sure you're opening the output file, not the original template
For more help, check out our Examples Gallery with downloadable templates you can study and modify.