Merge Codes Reference Guide
SWELL uses merge codes (also called template variables) to automatically insert dynamic data into proposals, contracts, invoices, and email templates. Type {{ in any supported editor to trigger the variable picker.
How Merge Codes Work
Merge codes use double curly braces with dot notation: {{category.field}}
When a document is generated or an email is sent, SWELL replaces each merge code with the actual data from your records. If a field is empty, the merge code is replaced with a blank string.
Contact Variables
Use these in proposals, contracts, invoices, and email templates to reference the client contact.
Merge Code | Description |
|---|---|
| Full name |
| First name |
| Last name |
| Email address |
| Phone number |
| Mobile number |
| Associated company name |
| Job title |
| Street address |
| City |
| State / Province |
| Zip / Postal code |
| Country |
| Website URL |
Company Variables
Reference the client's company details.
Merge Code | Description |
|---|---|
| Company name |
| Company email |
| Company phone |
| Company address |
| City |
| State / Province |
| Zip / Postal code |
| Country |
| Website URL |
| Industry type |
| Company size |
| Company description |
Proposal Variables
Available in proposal templates and proposal email notifications.
Merge Code | Description |
|---|---|
| Proposal title |
| Proposal number |
| Total amount |
| Subtotal before tax/discount |
| Tax amount |
| Discount amount |
| Currency code (e.g., USD) |
| Current status |
| Date created |
| Expiry date |
| Expiry date (alias) |
| Public view URL |
| Public signing URL |
| Full HTML content |
| Content preview (first 200 chars) |
Contract Variables
Available in contract templates and contract email notifications.
Merge Code | Description |
|---|---|
| Contract title |
| Contract number |
| Total amount |
| Subtotal before tax/discount |
| Tax amount |
| Discount amount |
| Currency code |
| Current status |
| Date created |
| Expiry date |
| Expiry date (alias) |
| Public view URL |
| Public signing URL |
| Full HTML content |
| Content preview (first 200 chars) |
| Contract notes/terms |
Invoice Variables
Available in invoice templates and payment reminder emails.
Merge Code | Description |
|---|---|
| Invoice number |
| Total amount |
| Subtotal |
| Tax amount |
| Discount amount |
| Currency code |
| Invoice status |
| Invoice date |
| Invoice date (alias) |
| Due date |
| Payment date |
| Days overdue |
| Public invoice URL |
| Payment link URL |
| Invoice notes |
| Payment terms |
Estimate Variables
Available in estimate templates and estimate email notifications.
Merge Code | Description |
|---|---|
| Estimate number |
| Total amount |
| Currency code |
| Status |
| Expiry date |
| Expiry date (alias) |
| Public URL |
| Notes |
| Terms |
System Variables
Available in all email templates. These reference your workspace settings.
Merge Code | Description |
|---|---|
| Today's date |
| Current time |
| Date and time combined |
| Your workspace/company name |
| Your workspace email |
| Your workspace phone |
| Your workspace address |
| Application URL |
Tenant and User Variables
Merge Code | Description |
|---|---|
| Current workspace name |
| Current user's full name |
| Current user's email |
| Current user's first name |
| Current user's last name |
Project and Task Variables
Available in project/task notifications.
Merge Code | Description |
|---|---|
| Project name |
| Project status |
| Task title |
| Task due date |
| Task priority |
Reminder Variables
Available in reminder notification emails.
Merge Code | Description |
|---|---|
| Reminder title |
| Reminder description |
| Reminder date/time |
| Related item name |
| Related item title |
| Related item URL |
Tips
- Variable Picker: In the proposal, contract, or email template editor, type
{{to open the variable picker and browse available merge codes. - Unresolved variables: If a merge code references a field with no data, it will be replaced with an empty string (no visible placeholder).
- Nested access: You can access nested properties using dot notation, e.g.
{{contact.company.name}}. - Where they work: Merge codes work in Proposals, Contracts, Invoices, Estimates, and Email Templates. They do not work in general notes or task descriptions.
Updated on: 30/06/2026
Thank you!
